home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-19 / gpt32src.zip / GNUPLOT.DOC < prev    next >
Text File  |  1992-03-25  |  98KB  |  2,671 lines

  1. 1 gnuplot
  2. ?
  3.  GNUPLOT is a command-driven interactive function plotting program. It
  4.  is case sensitive (commands and function names written in lowercase
  5.  are not the same as those written in CAPS). All command names may be
  6.  abbreviated, as long as the abbreviation is not ambiguous. Any number
  7.  of commands may appear on a line, separated by semicolons (;).
  8.  Strings are indicated with quotes.  They may be either single or double
  9.  quotation marks, e.g.,
  10.  
  11.           load "filename"
  12.           cd 'dir'
  13.  
  14.  Any command-line arguments are assumed to be names of files containing 
  15.  GNUPLOT commands, with the exception of standard X11 arguments, which
  16.  are processed first. Each file is loaded with the `load` command, in the
  17.  order specified. GNUPLOT exits after the last file is processed.  When
  18.  no load files are named, gnuplot enters into an interactive mode.
  19.  
  20.  Commands may extend over several input lines, by ending each 
  21.  line but the last with a backslash (\). The backslash must be the LAST
  22.  character on each line. The effect is as if the backslash and newline
  23.  were not there. That is, no white space is implied, nor is a comment
  24.  terminated. Therefore, commenting out a continued line comments out
  25.  the entire command (see `comment`).
  26.  
  27.  In this documentation, curly braces ({}) denote optional arguments to
  28.  many commands, and a vertical bar (|) separates mutually exclusive
  29.  choices.  GNUPLOT keywords or help topics are indicated by backquotes
  30.  or `boldface` (where available).  Angle brackets (<>) are used to mark
  31.  replaceable tokens.
  32.  
  33.  For help on any topic, type `help` followed by the name of the topic.
  34.  
  35.  The new GNUPLOT user should begin by reading about the `plot`
  36.  command (type `help plot`).
  37. 2 cd
  38. ?cd
  39.  The `cd` command changes the working directory.
  40.  
  41.  Syntax:
  42.          cd "<directory-name>"
  43.  
  44.  The directory name must be enclosed in quotes.
  45.  
  46.  Examples:
  47.          cd 'subdir'
  48.          cd ".."
  49. 2 clear
  50. ?clear
  51.  The `clear` command erases the current screen or output device as
  52.  specified by `set output`. This usually generates a formfeed on
  53.  hardcopy devices. Use `set terminal` to set the device type.
  54. 2 command-line editing
  55. ?line-editing
  56. ?editing
  57. ?history
  58.  The Unix and IBM PC versions of GNUPLOT support command-line editing.
  59.  Also, a history mechanism allows previous commands to be edited, and
  60.  re-executed. After the command line has been edited, a newline or
  61.  carriage return will enter the entire line regardless of where the
  62.  cursor is positioned.
  63.  
  64.  The editing commands are as follows:
  65.  
  66. @start table - first is interactive cleartext form
  67.  `Line editing`:
  68.  
  69.  ^B moves back a single character.
  70.  ^F moves forward a single character.
  71.  ^A moves to the beginning of the line.
  72.  ^E moves to the end of the line.
  73.  ^H and DEL delete the previous character.
  74.  ^D deletes the current character.
  75.  ^K deletes from current position to the end of line.
  76.  ^L,^R redraws line in case it gets trashed.
  77.  ^U deletes the entire line.
  78.  ^W deletes the last word.
  79.  
  80.  `History`:
  81.  
  82.  ^P moves back through history.
  83.  ^N moves forward through history.
  84. #Character && Function \\ \hline 
  85. #\multicolumn{3}{|c|}{Line Editing}\\
  86. #\verb~^B~ && move back a single character.\\
  87. #\verb~^F~ && move forward a single character.\\
  88. #\verb~^A~ && move to the beginning of the line.\\
  89. #\verb~^E~ && move to the end of the line.\\
  90. #\verb~^H, DEL~ && delete the previous character.\\
  91. #\verb~^D~ && delete the current character.\\
  92. #\verb~^K~ && delete from current position to the end of line.\\
  93. #\verb~^L, ^R~ && redraw line in case it gets trashed.\\
  94. #\verb~^U~ && delete the entire line. \\
  95. #\verb~^W~ && delete from the current word to the end of line. \\ \hline
  96. #\multicolumn{3}{|c|}{History} \\
  97. #\verb~^P~ && move back through history.\\
  98. #\verb~^N~ && move forward through history.\\
  99. %Character@@Function
  100. %_
  101. %@@Line Editing
  102. %^B@@move back a single character.
  103. %^F@@move forward a single character.
  104. %^A@@move to the beginning of the line.
  105. %^E@@move to the end of the line.
  106. %^H, DEL@@delete the previous character.
  107. %^D@@delete the current character.
  108. %^K@@delete from current position to the end of line.
  109. %^L, ^R@@redraw line in case it gets trashed.
  110. %^U@@delete the entire line.
  111. %^W@@delete from the current word to the end of line.
  112. %_
  113. %@@History
  114. %^P@@move back through history.
  115. %^N@@move forward through history.
  116. @end table 
  117.  
  118.  On the IBM PC the use of a TSR program such as DOSEDIT or CED may be
  119.  desired for line editing. For such a case GNUPLOT may be compiled with
  120.  no line editing capability (default makefile setup). Set READLINE in the
  121.  makefile and add readline.obj to the link file if GNUPLOT line editing
  122.  is to be used for the IBM PC. The following arrow keys may be used
  123.  on the IBM PC version if readline is used:
  124.  
  125. @start table - first is interactive cleartext form
  126.  Left  Arrow     - same as ^B.
  127.  Right Arrow     - same as ^F.
  128.  Ctl Left  Arrow - same as ^A.
  129.  Ctl Right Arrow - same as ^E.
  130.  Up    Arrow     - same as ^P.
  131.  Down  Arrow     - same as ^N.
  132. #Arrow key & Function & \\ \hline 
  133. #Left      & same as \verb~^B~. & \\
  134. #Right     & same as \verb~^F~. & \\
  135. #Ctl Left  & same as \verb~^A~. & \\
  136. #Ctl Right & same as \verb~^E~. & \\
  137. #Up        & same as \verb~^P~. & \\
  138. #Down      & same as \verb~^N~. & \\
  139. %Arrow key@@Function
  140. %_
  141. %Left Arrow@@same as ^B.
  142. %Right Arrow@@same as ^F.
  143. %Ctl Left Arrow@@same as ^A.
  144. %Ctl Right Arrow@@same as ^E.
  145. %Up Arrow@@same as ^P.
  146. %Down Arrow@@same as ^N.
  147. %_
  148. @end table
  149.  (The readline function in gnuplot is not the same as the readline used
  150.  in GNU BASH and GNU EMACS.  It is somewhat compatible however.) 
  151. 2 comment
  152. ?comments
  153.  Comments are supported as follows: a # may appear in most places in a line
  154.  and GNUPLOT will ignore the rest of the line. It will not have this
  155.  effect inside quotes, inside numbers (including complex numbers), inside
  156.  command substitutions, etc. In short, it works anywhere it makes sense
  157.  to work.
  158. 2 environment
  159. ?environment
  160.  A number of shell environment variables are understood by GNUPLOT.
  161.  None of these are required, but may be useful.
  162.  
  163.  If GNUTERM is defined, it is used as the name of the terminal type to
  164.  be used. This overrides any terminal type sensed by GNUPLOT on start
  165.  up, but is itself overridden by the .gnuplot (or equivalent) start-up
  166.  file (see `start-up`), and of course by later explicit changes.
  167.  
  168.  On Unix, AmigaDOS, and MS-DOS, GNUHELP may be defined to be the pathname
  169.  of the HELP file (gnuplot.gih).
  170.  
  171.  On VMS, the symbol GNUPLOT$HELP should be defined as the name of 
  172.  the help library for GNUPLOT.
  173.  
  174.  On Unix, HOME is used as the name of a directory to search for 
  175.  a .gnuplot file if none is found in the current directory.
  176.  On AmigaDOS and MS-DOS, GNUPLOT is used. On VMS, SYS$LOGIN: is used.
  177.  See help start-up.
  178.  
  179.  On Unix, PAGER is used as an output filter for help messages.
  180.  
  181.  On Unix and AmigaDOS, SHELL is used for the `shell` command. On MS-DOS,
  182.  COMSPEC is used for the `shell` command.
  183.  
  184.  On AmigaDOS, GNUFONT is used for the screen font.  For example:
  185.  "setenv GNUFONT sapphire/14".
  186.  
  187.  On MS-DOS, if the BGI interface is used, the variable `BGI` is used to point 
  188.  to the full path to the BGI drivers directory. Furthermore SVGA is used to
  189.  name the Super VGA BGI driver in 800x600 res., and its mode of operation
  190.  as 'Name.Mode'.
  191.  For example, if the Super VGA driver is C:\TC\BGI\SVGADRV.BGI and mode 3 is
  192.  used for 800x600 res., then: 'set BGI=C:\TC\BGI' and 'set SVGA=SVGADRV.3'.
  193. 2 exit
  194. ?exit
  195. ?quit
  196.  The commands `exit` and `quit` and the END-OF-FILE character
  197.  will exit GNUPLOT. All these commands will clear the output device
  198.  (as the `clear` command does) before exiting.
  199. 2 expressions
  200. ?expressions
  201.  In general, any mathematical expression accepted by C, FORTRAN,
  202.  Pascal, or BASIC is valid. The precedence of these operators is
  203.  determined by the specifications of the C programming language.
  204.  White space (spaces and tabs) is ignored inside expressions.
  205.  
  206.  Complex constants may be expressed as the {<real>,<imag>}, where <real>
  207.  and <imag> must be numerical constants. For example, {3,2}
  208.  represents 3 + 2i; {0,1} represents `i` itself. The curly braces 
  209.  are explicitly required here.
  210. 3 functions
  211. ?expressions functions
  212. ?functions
  213.  The functions in GNUPLOT are the same as the corresponding functions
  214.  in the Unix math library, except that all functions accept integer,
  215.  real, and complex arguments, unless otherwise noted. The `sgn`
  216.  function is also supported, as in BASIC.
  217. @start table
  218. #Function & Arguments & Returns \\ \hline
  219. %Function@Arguments@Returns
  220. %_
  221. 4 abs
  222. ?expressions functions abs
  223. ?functions abs
  224. ?abs
  225. #abs(x) & any  &  absolute value of {\tt x}, $|x|$; same type \\
  226. #abs(x) & complex &  length of {\tt x}, $\sqrt{{\mbox{real}(x)^{2} +
  227. #\mbox{imag}(x)^{2}}}$ \\
  228. %abs(x)@any@absolute value of x, $|x|$; same type 
  229. %abs(x)@complex@length of x, $sqrt{roman real (x) sup 2 + roman imag (x) sup 2}$ 
  230.  The `abs` function returns the absolute value of its argument. The
  231.  returned value is of the same type as the argument.
  232.  
  233.  For complex arguments, abs(x) is defined as the length of x in the
  234.  complex plane [i.e.,  sqrt(real(x)**2 + imag(x)**2) ].
  235. 4 acos
  236. ?expressions functions acos
  237. ?functions acos
  238. ?acos
  239. #acos(x) & any  & $\cos^{-1} x$ (inverse cosine) in radians \\
  240. %acos(x)@any@$cos sup -1 x$ (inverse cosine) in radians 
  241.  The `acos` function returns the arc cosine (inverse cosine) of its
  242.  argument. `acos` returns its argument in radians.
  243. 4 arg
  244. ?expressions functions arg
  245. ?functions arg
  246. ?arg
  247. #arg(x) & complex & the phase of $x$ in radians\\
  248. %arg(x)@complex@the phase of $x$ in radians
  249.  The `arg` function returns the phase of a complex number, in radians.
  250. 4 asin
  251. ?expressions functions asin
  252. ?functions asin
  253. ?asin
  254. #asin(x) & any  & $\sin^{-1} x$ (inverse sin) in radians \\
  255. %asin(x)@any@$sin sup -1 x$ (inverse sin) in radians 
  256.  The `asin` function returns the arc sin (inverse sin) of its argument.
  257.  `asin` returns its argument in radians.
  258. 4 atan
  259. ?expressions functions atan
  260. ?functions atan
  261. ?atan
  262. #atan(x) & any  & $\tan^{-1} x$ (inverse tangent) in radians \\
  263. %atan(x)@any@$tan sup -1 x$ (inverse tangent) in radians 
  264.  The `atan` function returns the arc tangent (inverse tangent) of its
  265.  argument. `atan` returns its argument in radians.
  266. 4 besj0
  267. ?expressions functions besj0
  268. ?functions besj0
  269. ?besj0
  270. #besj0(x) & radians &  $j_{0}$ Bessel function of $x$ \\
  271. %besj0(x)@radians@$j sub 0$ Bessel function of $x$ 
  272.  The `besj0` function returns the j0th Bessel function of its argument.
  273.  `besj0` expects its argument to be in radians.
  274. 4 besj1
  275. ?expressions functions besj1
  276. ?functions besj1
  277. ?besj1
  278. #besj1(x) & radians & $j_{1}$ Bessel function of $x$ \\
  279. %besj1(x)@radians@$j sub 1$ Bessel function of $x$ 
  280.  The `besj1` function returns the j1st Bessel function of its argument.
  281.  `besj1` expects its argument to be in radians.
  282. 4 besy0
  283. ?expressions functions besy0
  284. ?functions besy0
  285. ?besy0
  286. #besy0(x) & radians & $y_{0}$ Bessel function of $x$ \\
  287. %besy0(x)@radians@$y sub 0$ Bessel function of $x$ 
  288.  The `besy0` function returns the y0th Bessel function of its argument.
  289.  `besy0` expects its argument to be in radians.
  290. 4 besy1
  291. ?expressions functions besy1
  292. ?functions besy1
  293. ?besy1
  294. #besy1(x) & radians & $y_{1}$ Bessel function of $x$ \\
  295. %besy1(x)@radians@$y sub 1$ Bessel function of $x$ 
  296.  The `besy1` function returns the y1st Bessel function of its argument.
  297.  `besy1` expects its argument to be in radians.
  298. 4 ceil
  299. ?expressions functions ceil
  300. ?functions ceil
  301. ?ceil
  302. #ceil(x) & any & $\lceil x \rceil$, smallest integer not less than $x$
  303. #(real part) \\
  304. %ceil(x)@any@$left ceiling x right ceiling$, smallest integer not less than $x$ (real part) 
  305.  The `ceil` function returns the smallest integer that is not less than its
  306.  argument. For complex numbers, `ceil` returns the smallest integer
  307.  not less than the real part of its argument.
  308. 4 cos
  309. ?expressions functions cos
  310. ?functions cos
  311. ?cos
  312. #cos(x) & radians & $\cos x$, cosine of $x$ \\
  313. %cos(x)@radians@$cos~x$, cosine of $x$ 
  314.  The `cos` function returns the cosine of its argument. `cos` expects its
  315.  argument to be in radians.
  316. 4 cosh
  317. ?expressions functions cosh
  318. ?functions cosh
  319. ?cosh
  320. #cosh(x) & radians & $\cosh x$, hyperbolic cosine of $x$ \\
  321. %cosh(x)@radians@$cosh~x$, hyperbolic cosine of $x$ 
  322.  The `cosh` function returns the hyperbolic cosine of its argument.
  323.  `cosh` expects its argument to be in radians.
  324. 4 exp
  325. ?expressions functions exp
  326. ?functions exp
  327. ?exp
  328. #exp(x) & any & $e^{x}$,  exponential function of $x$ \\
  329. %exp(x)@any@$e sup x$, exponential function of $x$ 
  330.  The `exp` function returns the exponential function of its argument
  331.  (`e` raised to the power of its argument).
  332. 4 floor
  333. ?expressions functions floor
  334. ?functions floor
  335. ?floor
  336. #floor(x) & any & $\lfloor x \rfloor$,  largest integer not greater
  337. #than $x$ (real part) \\
  338. %floor(x)@any@$left floor x right floor$, largest integer not greater than $x$ (real part) 
  339.  The `floor` function returns the largest integer not greater than its
  340.  argument. For complex numbers, `floor` returns the largest
  341.  integer not greater than the real part of its argument.
  342. 4 gamma
  343. ?expressions functions gamma
  344. ?functions gamma
  345. ?gamma
  346. #gamma(x) & any & $\Gamma(\mbox{real}(x))$,  gamma function of real($x$) \\
  347. %gamma(x)@any@$GAMMA ( roman real (x))$, gamma function of real ($x$)
  348.  The `gamma` function returns the gamma function of the real part of
  349.  its argument. For integer n, gamma(n+1) = n! .
  350.  If the argument is a complex value, the imaginary component is ignored.
  351. 4 imag
  352. ?expressions functions imag
  353. ?functions imag
  354. ?imag
  355. #imag(x) & complex &  imaginary part of $x$ as a real number \\
  356. %imag(x)@complex@imaginary part of $x$ as a real number 
  357.  The `imag` function returns the imaginary part of its argument as a
  358.  real number.
  359. 4 int
  360. ?expressions functions int
  361. ?functions int
  362. ?int
  363. #int(x) & real &  integer part of $x$, truncated toward zero \\
  364. %int(x)@real@integer part of $x,$ truncated toward zero 
  365.  The `int` function returns the integer part of its argument, truncated
  366.  toward zero.
  367. 4 log
  368. ?expressions functions log
  369. ?functions log
  370. ?log
  371. #log(x) & any & $\log_{e} x$,  natural logarithm (base $e$) of $x$ \\
  372. %log(x)@any@$ln~x$, natural logarithm (base $e$) of $x$ 
  373.  The `log` function returns the natural logarithm (base `e`) of its
  374.  argument.
  375. 4 log10
  376. ?expressions functions log10
  377. ?functions log10
  378. ?log10
  379. #log10(x) & any & $\log_{10} x$,  logarithm (base $10$) of $x$ \\
  380. %log10(x)@any@${log sub 10}~x$, logarithm (base $10$) of $x$ 
  381.  The `log10` function returns the logarithm (base 10) of its argument.
  382. 4 real
  383. ?expressions functions real
  384. ?functions real
  385. ?real
  386. #real(x) & any &  real part of $x$ \\
  387. %real(x)@any@real part of $x$ 
  388.  The `real` function returns the real part of its argument.
  389. 4 sgn
  390. ?expressions functions sgn
  391. ?functions sgn
  392. ?sgn
  393. #sgn(x) & any & 1 if $x>0$, -1 if $x<0$, 0 if $x=0$. imag($x$) ignored \\
  394. %sgn(x)@any@1 if $x > 0$, -1 if $x < 0$, 0 if $x = 0$. $roman imag (x)$ ignored 
  395.  The `sgn` function returns 1 if its argument is positive, -1 if its
  396.  argument is negative, and 0 if its argument is 0. If the argument
  397.  is a complex value, the imaginary component is ignored.
  398. 4 sin
  399. ?expressions functions sin
  400. ?functions sin
  401. ?sin
  402. #sin(x) & radians & $\sin x$, sine of $x$ \\
  403. %sin(x)@radians@$sin~x$, sine of $x$ 
  404.  The `sin` function returns the sine of its argument. `sin` expects its
  405.  argument to be in radians.
  406. 4 sinh
  407. ?expressions functions sinh
  408. ?functions sinh
  409. ?sinh
  410. #sinh(x) & radians & $\sinh x$, hyperbolic sine $x$ \\
  411. %sinh(x)@radians@$sinh~x$, hyperbolic sine $x$ 
  412.  The `sinh` function returns the hyperbolic sine of its argument. `sinh`
  413.  expects its argument to be in radians.
  414. 4 sqrt
  415. ?expressions functions sqrt
  416. ?functions sqrt
  417. ?sqrt
  418. #sqrt(x) & any & $\sqrt{x}$,  square root of $x$ \\
  419. %sqrt(x)@any@$sqrt x $, square root of $x$ 
  420.  The `sqrt` function returns the square root of its argument.
  421. 4 tan
  422. ?expressions functions tan
  423. ?functions tan
  424. ?tan
  425. #tan(x) & radians & $\tan x$,  tangent of $x$ \\
  426. %tan(x)@radians@$tan~x$, tangent of $x$ 
  427.  The `tan` function returns the tangent of its argument. `tan` expects
  428.  its argument to be in radians.
  429. 4 tanh
  430. ?expressions functions tanh
  431. ?functions tanh
  432. ?tanh
  433. #tanh(x) & radians & $\tanh x$, hyperbolic tangent of $x$\\
  434. %tanh(x)@radians@$tanh~x$, hyperbolic tangent of $x$
  435.  The `tanh` function returns the hyperbolic tangent of its argument.
  436.  `tanh` expects its argument to be in radians.
  437. @end table
  438. 3 operators
  439. ?expressions operators
  440. ?operators
  441.  The operators in GNUPLOT are the same as the corresponding operators
  442.  in the C programming language, except that all operators accept
  443.  integer, real, and complex arguments, unless otherwise noted.
  444.  The ** operator (exponentiation) is supported, as in FORTRAN.
  445.  
  446.  Parentheses may be used to change order of evaluation.
  447. 4 binary
  448. ?expressions operators binary
  449. ?operators binary
  450. ?binary
  451.  The following is a list of all the binary operators and their
  452.  usages:
  453.  
  454. @start table - first is interactive cleartext form
  455.   Symbol      Example      Explanation
  456.    **          a**b          exponentiation
  457.    *           a*b           multiplication
  458.    /           a/b           division
  459.    %           a%b         * modulo
  460.    +           a+b           addition
  461.    -           a-b           subtraction
  462.    ==          a==b          equality
  463.    !=          a!=b          inequality
  464.    &           a&b         * bitwise AND
  465.    ^           a^b         * bitwise exclusive OR
  466.    |           a|b         * bitwise inclusive OR
  467.    &&          a&&b        * logical AND
  468.    ||          a||b        * logical OR
  469.    ?:          a?b:c       * ternary operation
  470. #\multicolumn{3}{|c|}{Binary Operators} \\
  471. #Symbol & Example & Explanation \\ \hline
  472. #\verb~**~ & \verb~a**b~ & exponentiation\\
  473. #\verb~*~ & \verb~a*b~ & multiplication\\
  474. #\verb~/~ & \verb~a/b~ & division\\
  475. #\verb~%~ & \verb~a%b~ & * modulo\\
  476. #\verb~+~ & \verb~a+b~ & addition\\
  477. #\verb~-~ & \verb~a-b~ & subtraction\\
  478. #\verb~==~ & \verb~a==b~ & equality\\
  479. #\verb~!=~ & \verb~a!=b~ & inequality\\
  480. #\verb~&~ & \verb~a&b~ & * bitwise AND\\
  481. #\verb~^~ & \verb~a^b~ & * bitwise exclusive OR\\
  482. #\verb~|~ & \verb~a|b~ & * bitwise inclusive OR\\
  483. #\verb~&&~ & \verb~a&&b~ & * logical AND\\
  484. #\verb~||~ & \verb~a||b~ & * logical OR\\
  485. #\verb~?:~ & \verb~a?b:c~ & * ternary operation\\
  486. %Symbol@Example@Explanation
  487. %_
  488. %**@a**b@exponentiation
  489. %*@a*b@multiplication
  490. %/@a/b@division
  491. %%@a%b@* modulo
  492. %+@a+b@addition
  493. %-@a-b@subtraction
  494. %==@a==b@equality
  495. %!=@a!=b@inequality
  496. %&@a&b@* bitwise AND
  497. %^@a^b@* bitwise exclusive OR
  498. %|@a|b@* bitwise inclusive OR
  499. %&&@a&&b@* logical AND
  500. %||@a||b@* logical OR
  501. %?:@a?b:c@* ternary operation
  502.  
  503. @end table 
  504.  (*) Starred explanations indicate that the operator requires
  505.  integer arguments.
  506.  
  507.  Logical AND (&&) and OR (||) short-circuit the way they do in C.
  508.  That is, the second && operand is not evaluated if the first is
  509.  false; the second || operand is not evaluated if the first is true.
  510.  
  511.  The ternary operator evaluates its first argument (a). If it is
  512.  true (non-zero) the second argument (b) is evaluated and returned,
  513.  otherwise the third argument (c) is evaluated and returned.
  514. 4 unary
  515. ?expressions operators unary
  516. ?operators unary
  517. ?unary
  518.  The following is a list of all the unary operators and their
  519.  usages:
  520.  
  521. @start table - first is interactive cleartext form
  522.   Symbol     Example      Explanation
  523.    -           -a          unary minus
  524.    ~           ~a        * one's complement
  525.    !           !a        * logical negation
  526.    !           a!        * factorial
  527. #\multicolumn{3}{|c|}{Unary Operators}\\
  528. #Symbol & Example & Explanation \\ \hline
  529. #\verb@-@ & \verb@-a@ & unary minus \\
  530. #\verb@~@ & \verb@~a@ & * one's complement \\
  531. #\verb@!@ & \verb@!a@ & * logical negation \\
  532. #\verb@!@ & \verb@a!@ & * factorial \\
  533. %-@-a@unary minus
  534. %~@~a@* one's complement
  535. %!@!a@* logical negation
  536. %!@a!@* factorial
  537.  
  538. @end table 
  539.  (*) Starred explanations indicate that the operator requires an
  540.  integer argument.
  541.  
  542.  The factorial operator returns a real number to allow a greater range.
  543. 2 help
  544. ?help
  545.  The `help` command displays on-line help. To specify information on a
  546.  particular topic use the syntax:
  547.  
  548.          help {<topic>}
  549.  
  550.  If <topic> is not specified, a short message is printed about
  551.  GNUPLOT. After help for the requested topic is given, help for a
  552.  subtopic may be requested by typing its name, extending the help
  553.  request. After that subtopic has been printed, the request may be
  554.  extended again, or simply pressing return goes back one level to the
  555.  previous topic. Eventually, the GNUPLOT command line will return.
  556. 2 load
  557. ?load
  558.  The `load` command executes each line of the specified input file as
  559.  if it had been typed in interactively. Files created by the `save`
  560.  command can later be `load`ed. Any text file containing valid
  561.  commands can be created and then executed by the `load` command.
  562.  Files being `load`ed may themselves contain `load` commands. See
  563.  `comment` for information about comments in commands.
  564.  
  565.  The `load` command must be the last command on the line.
  566.  
  567.  Syntax:
  568.          load "<input-file>"
  569.  
  570.  The name of the input file must be enclosed in quotes.
  571.  
  572.  Examples:
  573.  
  574.          load 'work.gnu'
  575.          load "func.dat"
  576.  
  577.  The `load` command is performed implicitly on any file names given as
  578.  arguments to GNUPLOT. These are loaded in the order specified, and
  579.  then GNUPLOT exits.
  580. 2 pause
  581. ?pause
  582.  The `pause` command displays any text associated with the command and
  583.  then waits a specified amount of time or until the carriage return is
  584.  pressed.  `pause` is especially useful in conjunction with `load` files.
  585.  
  586.  Syntax:
  587.          pause <time> {"<string>"}
  588.  
  589.  <time> may be any integer constant or expression. Choosing -1 will
  590.  wait until a carriage return is hit, zero (0) won't pause at all, and
  591.  a positive integer will wait the specified number of seconds.
  592.  
  593.  Note: Since `pause` is not part of the plot it may interact with
  594.  different device drivers differently (depending upon how text and
  595.  graphics are mixed).
  596.  
  597.  Examples:
  598.          pause -1    # Wait until a carriage return is hit
  599.          pause 3     # Wait three seconds
  600.          pause -1  "Hit return to continue"
  601.          pause 10  "Isn't this pretty?  It's a cubic-spline."
  602.  
  603. 2 plot
  604. ?plot
  605. ?splot
  606.  `plot` and `splot` are the primary commands of the program. They plot
  607.  functions and data in many, many ways. `plot` is used to plot 2-d
  608.  functions and data, while `splot` plots 3-d surfaces and data.
  609.  
  610.  Syntax:
  611.  
  612.          plot {ranges}  <function> {title} {style}
  613.                      {, <function> {title} {style}...}
  614.  
  615.          splot {ranges}  <function> {title} {style}
  616.                       {, <function> {title} {style}...}
  617.  
  618.  where <function> is either a mathematical expression, the name of a
  619.  data file enclosed in quotes, or a pair (`plot`) or triple (`splot`)
  620.  of mathematical expressions in the case of parametric functions.
  621.  User-defined functions and variables may also be defined here.
  622.  
  623.  `plot` and `splot` commands can be as simple as
  624.  
  625.          plot sin(x)
  626.  
  627.  and
  628.  
  629.          splot x * y
  630.  
  631.  or as complex as (!)
  632.  
  633.          plot [t=1:10] [-pi:pi*2] tan(t),"data.1" with lines,t**2 with points
  634. 3 data-file
  635. ?plot datafile
  636. ?plot data-file
  637. ?splot datafile
  638. ?splot data-file
  639. ?datafile
  640. ?data-file
  641. ?data
  642.  Discrete data contained in a file can displayed by specifying the
  643.  name of the data file (enclosed in quotes) on the `plot` or `splot`
  644.  command line. Data files should contain one data point per line.
  645.  Lines beginning with # (or ! on VMS) will be treated as comments
  646.  and ignored. For `plot`s, each data point represents an (x,y)
  647.  pair. For `splot`s, each point is an (x,y,z) triple. For `plot`s with
  648.  error bars (see `plot errorbars`), each data point is either
  649.  (x,y,ydelta) or (x,y,ylow,yhigh). In all cases, the numbers on each
  650.  line of a data file must be separated by blank space. This blank
  651.  space divides each line into columns.
  652.  
  653.  For `plot`s the x value may be omitted, and for `splot`s the x
  654.  and y values may be omitted. In either case the omitted values are
  655.  assigned the current coordinate number. Coordinate numbers start at 0
  656.  and are incremented for each data point read.
  657.  
  658.  To specify other formats, see `plot datafile using`.
  659.  
  660.  In the `plot` command, blank lines in the data file cause a break in
  661.  the plot. There will be no line drawn between the preceding and
  662.  following points if the plot style is `lines` or `linespoints` (see
  663.  `plot style`). This does not change the plot style, as would plotting
  664.  the data as separate curves.
  665.  
  666.  This example compares the data in the file population.dat to a
  667.  theoretical curve:
  668.  
  669.          pop(x) = 103*exp((1965-x)/10)
  670.          plot [1960:1990] 'population.dat', pop(x)
  671.  
  672.  The file population.dat might contain:
  673.  
  674.          # Gnu population in Antarctica since 1965
  675.          1965   103
  676.          1970   55
  677.          1975   34
  678.          1980   24
  679.          1985   10
  680.  
  681.  When a data file is plotted, `samples` and `iso_samples` are ignored.
  682.  Curves plotted using the `plot` command are automatically extended to
  683.  hold the entire curve. Similarly grid data plotted using the `splot`
  684.  command is automatically extended, using the assumption that isolines
  685.  are separated by blank lines (a line with only a CR/LF in it).
  686.  
  687.  Implicitly, there are two types of 3-d datafiles. If all the isolines
  688.  are of the same length, the data is assumed to be a grid data, i.e.,
  689.  the data has a grid topology. Cross isolines in the other parametric
  690.  direction (the ith cross isoline passes thru the ith point of all the
  691.  provided isolines) will also be drawn for grid data. (Note contouring
  692.  is available for grid data only.) If all the isolines are not of the
  693.  same length, no cross isolines will be drawn and contouring that data
  694.  is impossible.
  695.  
  696.  For splot if 3-d datafile and using format (see `splot datafile using`)
  697.  specify only z (height field), a non parametric mode must be specified.
  698.  If, on the other hand, x, y, and z are all specified, a parametric
  699.  mode should be selected (see `set parametric`) since data is defining a
  700.  parametric surface.
  701.  
  702.  A simple example of plotting a 3-d data file is
  703.  
  704.          set parametric
  705.          splot 'glass.dat'
  706.  
  707.  or
  708.  
  709.          set noparametric
  710.          splot 'datafile.dat'
  711.  
  712.  where the file datafile.dat might contain:
  713.  
  714.          # The valley of the Gnu.
  715.          10
  716.          10
  717.          10
  718.  
  719.          10
  720.          5
  721.          10
  722.  
  723.          10
  724.          1
  725.          10
  726.  
  727.          10
  728.          0
  729.          10
  730.  
  731.  Note datafile.dat defines a 4 by 3 grid ( 4 rows of 3 points each ).
  732.  Rows are separated by blank lines.
  733.  
  734.  On some computer systems with a popen function (UNIX), the datafile
  735.  can be piped through a shell command by starting the file name
  736.  with a '<'.  For example:
  737.  
  738.          pop(x) = 103*exp(x/10)
  739.          plot '< awk "{print $1-1965 $2}" population.dat', pop(x)
  740.  
  741.  would plot the same information as the first population example
  742.  but with years since 1965 as the x axis.
  743.  
  744.  For more information about 3-d plotting, see `splot`.
  745. 4 using
  746. ?plot datafile using
  747. ?plot data-file using
  748. ?splot datafile using
  749. ?splot data-file using
  750. ?using
  751.  The format of data within a file can be selected with the `using` 
  752.  option. An explicit scanf string can be used, or simpler column
  753.  choices can be made.
  754.  
  755.  Syntax:
  756.  
  757.          plot "datafile" { using { <ycol> |
  758.                                    <xcol>:<ycol> |
  759.                                    <xcol>:<ycol>:<ydelta> |
  760.                                    <xcol>:<ycol>:<ylow>:<yhigh> }
  761.                                  {"<scanf string>"} } ...
  762.  
  763.  and
  764.  
  765.          splot "datafile" { using { <xcol>:<ycol>:<zcol> | <zcol> }
  766.                                   {"<scanf string>"} } ...
  767.  
  768.  <xcol>, <ycol>, and <zcol> explicitly select the columns to plot from
  769.  a space or tab separated multicolumn data file. If only <ycol> is
  770.  selected for `plot`, <xcol> defaults to 1. If only <zcol> is selected
  771.  for `splot`, then only that column is read from the file. An <xcol> of
  772.  0 forces <ycol> to be plotted versus its coordinate number. <xcol>,
  773.  <ycol>, and <zcol> can be entered as constants or expressions.
  774.  
  775.  If errorbars (see also `plot errorbars`) are used for `plot`s,
  776.  ydelta (for example, a +/- error) should be provided as the third
  777.  column, or ylow and yhigh as third and fourth columns.  These columns
  778.  must follow the x and y columns.
  779.  
  780.  Scanf strings override any <xcol>:<ycol>(:<zcol>) choices, except for
  781.  ordering of input, e.g.,
  782.          plot "datafile" using 2:1 "%f%*f%f"
  783.  causes the first column to be y and the third column to be x.
  784.  
  785.  If the scanf string is omitted, the default is generated based on the
  786.  <xcol>:<ycol>(:<zcol>) choices. If the `using` option is omitted, "%f%f"
  787.  is used for `plot` ("%f%f%f%f" for `errorbar` `plot`s) and "%f%f%f" is
  788.  used for `splot`.
  789.  
  790.  Examples:
  791.  
  792.          plot "MyData" using "%*f%f%*20[^\n]%f" with lines
  793.  
  794.  Data are read from the file "MyData" using the format
  795.  "%*f%f%*20[^\n]%f". The meaning of this format is: "%*f" ignore the
  796.  first number, "%f" then read in the second and assign to x,
  797.  "%*20[^\n]" then ignore 20 non-newline characters, "%f" then read in
  798.  the y value.
  799.  
  800.          n=3;
  801.          plot "MyData", "MyData" using n 
  802.  
  803.  causes GNUPLOT to plot the second and third columns of MyData versus
  804.  the first column. The command 'n=4; replot' would then plot the second
  805.  and fourth columns of MyData versus the first column.
  806.  
  807.          splot "glass.dat" using 1
  808.  
  809.  causes GNUPLOT to plot the first coordinate of the points of glass.dat
  810.  as the z coordinate while ignoring the other two coordinates.
  811.  
  812.  Note: GNUPLOT first reads a line of the data file into a buffer and 
  813.  then does a 
  814.          sscanf(input_buffer, scanf_string, &x, &y{, &z});
  815.  where 'x', 'y', and 'z' are of type 'float'. Any scanf string that
  816.  specifies two (three for `splot`, three or four for `errorbars`) float
  817.  numbers may be used.
  818. 3 errorbars
  819. ?plot errorbars
  820. ?errorbars
  821.  Error bars are supported for 2-d data file plots by reading one or
  822.  two additional columns specifying ydelta or ylow and yhigh
  823.  respectively. No support exists for x error bars or any error bars
  824.  for `splot`s.
  825.  
  826.  In the default situation, GNUPLOT expects to see three or four
  827.  numbers on each line of the data file, either (x, y, ydelta) or 
  828.  (x, y, ylow, yhigh). The x coordinate must be specified. The order
  829.  of the numbers must be exactly as given above. Data files in this
  830.  format can easily be plotted with error bars:
  831.  
  832.          plot "data.dat" with errorbars
  833.  
  834.  The error bar is a vertical line plotted from (x, ylow) to (x,
  835.  yhigh). If ydelta is specified instead of ylow and yhigh, 
  836.  ylow=y-ydelta and yhigh=y+ydelta are derived. If there
  837.  are only two numbers on the line, yhigh and ylow are both set to
  838.  y. To get lines plotted between the data points, `plot` the
  839.  data file twice, once with errorbars and once with lines.
  840.  
  841.  If y autoscaling is on, the y range will be adjusted to fit the
  842.  error bars.
  843.  
  844.  The `using` option may be used to specify how columns of the data file
  845.  are to be assigned to x, y, ydelta, ylow, and yhigh. The x column must
  846.  be provided and both the x and y columns must appear before the
  847.  errorbar columns. If three column numbers are given, they are x, y,
  848.  and ydelta. If four columns are given, they are x, y, ylow, and
  849.  yhigh.
  850.  
  851.  Examples:
  852.  
  853.          plot "data.dat" using 1:2:3:4 with errorbars
  854.          plot "data.dat" using 3:2:6 with errorbars
  855.          plot "data.dat" using 3:4:8:7 with errorbars
  856.  
  857.  The first example reads, x, y, ylow, and yhigh, from columns 1, 2, 3,
  858.  and 4. This is equivalent to the default.  The second example reads x
  859.  from the third column, y from second and ydelta from the sixth column.
  860.  The third example reads x from the third column, y from the fourth,
  861.  ylow from the eighth, and yhigh from seventh columns.
  862.  
  863.  See also `plot using` and `plot style`.
  864. 3 parametric
  865. ?plot parametric
  866. ?splot parametric
  867. ?parametric
  868.  When in parametric mode (`set parametric`) mathematical expressions must
  869.  be given in pairs for `plot` and in triplets for `splot`:
  870.          plot sin(t),t**2
  871.  or
  872.          splot cos(u)*cos(v),cos(u)*sin(v),sin(u)
  873.  
  874.  Data files are plotted as before, except any preceding parametric
  875.  function must be fully specified before a data file is given as a
  876.  plot. In other words, the x parametric function (sin(t) above) and
  877.  the y parametric function (t**2 above) must not be interrupted with
  878.  any modifiers or data functions; doing so will generate a syntax error
  879.  stating that the parametric function is not fully specified.
  880.  
  881.  Ranges take on a different meaning when in parametric mode. The first
  882.  range on the `plot` command is the `trange`, the next is the `xrange`,
  883.  and the last is the `yrange`. For `splot` the order is `urange`,
  884.  `vrange`, `xrange`, `yrange`, and finally `zrange`. The following
  885.  `plot` command shows setting the `trange` to [-pi:pi], the `xrange` to
  886.  [-1.3:1.3] and the `yrange` to [-1:1] for the duration of the plot:
  887.          plot [-pi:pi] [-1.3:1.3] [-1:1] sin(t),t**2
  888.  
  889.  Other modifiers, such as `with` and `title`, may be specified only
  890.  after the parametric function has been completed:
  891.          plot sin(t),t**2 title 'Parametric example' with linespoints
  892. 3 ranges
  893. ?splot ranges
  894. ?plot ranges
  895. ?ranges
  896.  The optional range specifies the region of the plot that will be
  897.  displayed.
  898.  
  899.  Ranges may be provided on the `plot` and `splot` command line and
  900.  affect only that plot, or in the `set xrange`, `set yrange`, etc.,
  901.  commands, to change the default ranges for future plots.
  902.  
  903.  Syntax:
  904.          [{<dummy-var> =} {<xmin> : <xmax>}] { [{<ymin> : <ymax>}] }
  905.  
  906.  where <dummy-var> is the independent variable (the defaults are x and
  907.  y, but this may be changed with `set dummy`) and the min and max
  908.  terms can be constant expressions.
  909.  
  910.  Both the min and max terms are optional. The ':' is also optional
  911.  if neither a min nor a max term is specified. This allows '[ ]' to
  912.  be used as a null range specification.
  913.  
  914.  Specifying a range in the `plot` command line turns autoscaling for
  915.  that axis off for that plot. Using one of the `set` range commands
  916.  turns autoscaling off for that axis for future plots, unless changed
  917.  later. (See `set autoscale`).
  918.  
  919.  Examples:
  920.  
  921.  This uses the current ranges:
  922.          plot cos(x)
  923.  
  924.  This sets the x range only:
  925.          plot [-10:30] sin(pi*x)/(pi*x)
  926.  
  927.  This is the same, but uses t as the dummy-variable:
  928.          plot [t = -10 :30]  sin(pi*t)/(pi*t)
  929.  
  930.  This sets both the x and y ranges:
  931.          plot [-pi:pi] [-3:3]  tan(x), 1/x
  932.  
  933.  This sets only the y range, and turns off autoscaling on both axes:
  934.          plot [ ] [-2:sin(5)*-8] sin(x)**besj0(x)
  935.  
  936.  This sets xmax and ymin only:
  937.          plot [:200] [-pi:]  exp(sin(x))
  938.  
  939.  This sets the x, y, and z ranges:
  940.          splot [0:3] [1:4] [-1:1] x*y
  941. 3 style
  942. ?plot style
  943. ?splot style
  944. ?style
  945. ?plot with
  946. ?with
  947.  Plots may be displayed in one of six styles: `lines`, `points`,
  948.  `linespoints`, `impulses`, `dots`, or `errorbars`. The `lines` style
  949.  connects adjacent points with lines. The `points` style displays a
  950.  small symbol at each point. The `linespoints` style does both
  951.  `lines` and `points`. The `impulses` style displays a vertical line
  952.  from the x axis (or from the grid base for `splot`) to each point. The
  953.  `dots` style plots a tiny dot at each point; this is useful for
  954.  scatter plots with many points.
  955.  
  956.  The `errorbars` style is only relevant to 2-d data file plotting. It
  957.  is treated like `points` for `splot`s and function `plot`s. For data
  958.  `plot`s, `errorbars` is like `points`, except that a vertical error 
  959.  bar is also drawn: for each point (x,y), a line is drawn from
  960.  (x,ylow) to (x,yhigh). A tic mark is placed at the ends of the error
  961.  bar. The ylow and yhigh values are read from the data file's columns,
  962.  as specified with the `using` option to plot. See `plot errorbars` for
  963.  more information.
  964.  
  965.  Default styles are chosen with the `set function style` and
  966.  `set data style` commands.
  967.  
  968.  By default, each function and data file will use a different 
  969.  line type and point type, up to the maximum number of available 
  970.  types. All terminal drivers support at least six different point
  971.  types, and re-use them, in order, if more than six are required.
  972.  The LaTeX driver supplies an additional six point types (all variants
  973.  of a circle), and thus will only repeat after twelve curves are
  974.  plotted with points.
  975.  
  976.  If desired, the style and (optionally) the line type and point type
  977.  used for a curve can be specified.
  978.  
  979.  Syntax:
  980.  
  981.          with <style> {<linetype> {<pointtype>}}
  982.  
  983.  where <style> is either `lines`, `points`, `linespoints`, `impulses`,
  984.  `dots`, or `errorbars`. The <linetype> and <pointtype> are positive
  985.  integer constants or expressions and specify the line type and point
  986.  type to be used for the plot. Line type 1 is the first line type used
  987.  by default, line type 2 is the second line type used by default, etc.
  988.  
  989.  Examples:
  990.  
  991.  This plots sin(x) with impulses:
  992.          plot sin(x) with impulses
  993.  
  994.  This plots x*y with points, x**2 + y**2 default:
  995.          splot x*y w points, x**2 + y**2
  996.  
  997.  This plots tan(x) with the default function style, "data.1" with lines:
  998.          plot [ ] [-2:5] tan(x), "data.1" with l
  999.  
  1000.  This plots "leastsq.dat" with impulses:
  1001.          plot 'leastsq.dat' w i
  1002.  
  1003.  This plots "exper.dat" with errorbars and lines connecting the points:
  1004.          plot 'exper.dat' w lines, 'exper.dat' w errorbars
  1005.  Here 'exper.dat' should have three or four data columns.
  1006.  
  1007.  This plots x**2 + y**2 and x**2 - y**2 with the same line type:
  1008.          splot x**2 + y**2 with line 1, x**2 - y**2 with line 1
  1009.  
  1010.  This plots sin(x) and cos(x) with linespoints, using the
  1011.  same line type but different point types:
  1012.          plot sin(x) with linesp 1 3, cos(x) with linesp 1 4
  1013.  
  1014.  This plots file "data" with points style 3:
  1015.          plot "data" with points 1 3 
  1016.  Note that the line style must be specified when specifying the point
  1017.  style, even when it is irrelevant. Here the line style is 1 and the
  1018.  point style is 3, and the line style is irrelevant.
  1019.  
  1020.  See `set style` to change the default styles.
  1021. 3 title
  1022. ?plot title
  1023. ?splot title
  1024.  A title of each plot appears in the key. By default the title is
  1025.  the function or file name as it appears on the plot command line.
  1026.  The title can be changed by using the `title` option. This option 
  1027.  should precede any `with` option.
  1028.  
  1029.  Syntax:
  1030.          title "<title>"
  1031.  
  1032.  where <title> is the new title of the plot and must be enclosed in
  1033.  quotes. The quotes will not be shown in the key.
  1034.  
  1035.  Examples:
  1036.  
  1037.  This plots y=x with the title 'x':
  1038.          plot x
  1039.  
  1040.  This plots the "glass.dat" file with the title 'surface of revolution':
  1041.          splot "glass.dat" title 'surface of revolution'
  1042.  
  1043.  This plots x squared with title "x^2" and "data.1" with title
  1044.  'measured data':
  1045.          plot x**2 title "x^2", "data.1" t 'measured data'
  1046. 2 print
  1047. ?print
  1048.  The `print` command prints the value of <expression> to the screen.
  1049.  
  1050.  Syntax:
  1051.          print <expression>
  1052.  
  1053.  See `expressions`.
  1054. 2 pwd
  1055. ?pwd
  1056.  The `pwd` command prints the name of the working directory to the screen.
  1057.  
  1058.  Syntax:
  1059.          pwd
  1060. 2 quit
  1061. ?quit
  1062.  The `exit` and `quit` commands and END-OF-FILE character will exit
  1063.  GNUPLOT. All these commands will clear the output device (as the
  1064.  `clear` command does) before exiting.
  1065. 2 replot
  1066. ?replot
  1067.  The `replot` command without arguments repeats the last `plot` or `splot`
  1068.  command. This can be useful for viewing a plot with different `set`
  1069.  options, or when generating the same plot for several devices.
  1070.  
  1071.  Arguments specified after a `replot` command will be added onto the last
  1072.  `plot` (`splot`) command (with an implied ',' separator) before it is
  1073.  repeated. `replot` accepts the same arguments as the `plot` (`splot`)
  1074.  commands except that ranges cannot be specified. See `command-line
  1075.  editing` for ways to edit the last `plot` (`splot`) command.
  1076. 2 save
  1077. ?save
  1078.  The `save` command saves user-defined functions, variables, set
  1079.  options or all three plus the last `plot` (`splot`) command to the
  1080.  specified file.
  1081.  
  1082.  Syntax:
  1083.          save  {<option>} "<filename>"
  1084.  
  1085.  where <option> is `functions`, `variables` or `set`. If no option is
  1086.  used, GNUPLOT saves functions, variables, set options and the last `plot`
  1087.  (`splot`) command.
  1088.  
  1089.  `save`d files are written in text format and may be read by the `load`
  1090.  command.
  1091.  
  1092.  The filename must be enclosed in quotes.
  1093.  
  1094.  Examples:
  1095.  
  1096.          save "work.gnu"
  1097.          save functions 'func.dat'
  1098.          save var 'var.dat'
  1099.          save set "options.dat"
  1100. 2 set-show
  1101. ?set
  1102. ?show
  1103.  The `set` command sets LOTS of options.
  1104.  
  1105.  The `show` command shows their settings. `show all` shows all the
  1106.  settings.
  1107. 3 angles
  1108. ?set angles
  1109. ?show angles
  1110. ?angles
  1111.  By default, GNUPLOT assumes the independent variable in polar plots
  1112.  is in units of radians. If `set angles degrees` is specified before
  1113.  `set polar` then the default range is [0:360] and the independent
  1114.  variable has units of degrees. This is particularly useful for
  1115.  plots of data files. The angle setting also hold for the 3-d
  1116.  mapping as set via the `set mapping` command.
  1117.  
  1118.  Syntax:
  1119.          set angles { degrees | radians }
  1120.          show angles
  1121. 3 arrow
  1122. ?set arrow
  1123. ?set noarrow
  1124. ?show arrow
  1125. ?arrow
  1126. ?noarrow
  1127.  Arbitrary arrows can be placed on a plot using the `set arrow`
  1128.  command.
  1129.  
  1130.  Syntax:
  1131.  
  1132.           set arrow {<tag>} {from <sx>,<sy>{,<sz>}} 
  1133.                             {to <ex>,<ey>{,<ez>}} {{no}head}
  1134.           set noarrow {<tag>}
  1135.           show arrow
  1136.  
  1137.  
  1138.  Unspecified coordinates default to 0. The x, y, and z values are in
  1139.  the graph's coordinate system. The z coordinate is only used in
  1140.  `splot` commands. <tag> is an integer that identifies the arrow. If no
  1141.  tag is given, the lowest unused tag value is assigned automatically.
  1142.  The tag can be used to delete or change a specific arrow. To change
  1143.  any attribute of an existing arrow, use the `set arrow` command with
  1144.  the appropriate tag, and specify the parts of the arrow to be
  1145.  changed. Specifying nohead requests the arrow be drawn without a head
  1146.  (yielding a line segment). By default, arrows have heads.
  1147.  
  1148.  Arrows outside the plotted boundaries are permitted but may cause
  1149.  device errors.
  1150.  
  1151.  Examples:
  1152.  
  1153.  To set an arrow pointing from the origin to (1,2), use:
  1154.           set arrow to 1,2
  1155.  To set an arrow from (-10,4,2) to (-5,5,3), and tag the arrow number
  1156.  3, use:
  1157.           set arrow 3 from -10,4,2 to -5,5,3
  1158.  To change the preceding arrow begin at 1,1,1, without an arrow head,
  1159.  use:
  1160.           set arrow 3 from 1,1,1 nohead
  1161.  To delete arrow number 2 use:
  1162.           set noarrow 2
  1163.  To delete all arrows use:
  1164.           set noarrow
  1165.  To show all arrows (in tag order) use:
  1166.           show arrow
  1167. 3 autoscale
  1168. ?set autoscale
  1169. ?set noautoscale
  1170. ?show autoscale
  1171. ?autoscale
  1172. ?noautoscale
  1173.  Auto scaling may be set individually on the x, y or z axis
  1174.  or globally on all axes. The default is to autoscale all axes.
  1175.  
  1176.  When autoscaling, the plot range is automatically computed and the
  1177.  dependent axis (y for a `plot` and z for `splot`) is scaled to
  1178.  include the range of the function or data being plotted.
  1179.  
  1180.  If autoscaling of the dependent axis (y or z) is not set, the
  1181.  current y or z range is used.
  1182.  
  1183.  See `set yrange` or `set zrange`.
  1184.  
  1185.  Autoscaling the independent variables (x for `plot` and x,y for
  1186.  `splot`) is a request to set the domain to match any data file being
  1187.  plotted. If there are no data files then autoscaling an independent
  1188.  variable has no effect. In other words, in the absence of a data
  1189.  file, functions alone do not affect the x range (or the y range if
  1190.  plotting z = f(x,y)).
  1191.  
  1192.  See `set xrange`, or `set yrange`.
  1193.  
  1194.  The behavior of autoscaling remains consistent in parametric mode,
  1195.  however, there are more dependent variables and hence more control
  1196.  over x, y, and z plot scales. In parametric mode, the independent or
  1197.  dummy variable is t for `plot`s and u,v for `splot`s.  Autoscale in
  1198.  parametric mode, then, controls all ranges (t, u, v, x, y, and z) and
  1199.  allows x, y, and z to be fully autoscaled.
  1200.  
  1201.  See `set parametric`.
  1202.  
  1203.  Syntax:
  1204.          set autoscale <axes>
  1205.          set noautoscale <axes>
  1206.          show autoscale
  1207.  
  1208.  where <axes> is either `x`, `y`, `z` or `xy`. If <axes> is not given
  1209.  then all axes are assumed.
  1210.  
  1211.  Examples:
  1212.  
  1213.  This sets autoscaling of the y axis. x axis autoscaling is not
  1214.  affected.
  1215.          set autoscale y
  1216.  
  1217.  This sets autoscaling of the x and y axes.
  1218.          set autoscale xy
  1219.  
  1220.  This sets autoscaling of the x, y and z axes.
  1221.          set autoscale
  1222.  
  1223.  This disables autoscaling of the x, y and z axes.
  1224.          set noautoscale
  1225.  
  1226.  This disables autoscaling of the z axis only.
  1227.          set noautoscale z
  1228. 4 parametric mode
  1229. ?autoscale parametric
  1230. ?set autoscale t
  1231.  When in parametric mode (`set parametric`) the xrange is as
  1232.  fully scalable as the yrange. In other words, in parametric
  1233.  mode the x axis can be automatically scaled to fit the range
  1234.  of the parametric function that is being plotted. Of course,
  1235.  the y axis can also be automatically scaled just as in the
  1236.  non-parametric case. If autoscaling on the x axis is not set,
  1237.  the current x range is used.
  1238.  
  1239.  When there is a mix of data files and functions, the xrange of
  1240.  the functions is selected as that of the data files if autoscale
  1241.  is true for x. While this keeps the behavior compatible with
  1242.  non-parametric plotting, it may not be retained in the future.
  1243.  The problem is that, in parametric mode, the x and y ranges are
  1244.  not as distinguishable as in the non-parametric mode and this
  1245.  behavior may not be the most useful.
  1246.  
  1247.  For completeness a last command `set autoscale t` is accepted.
  1248.  However, the effect of this "scaling" is very minor. When
  1249.  GNUPLOT determines that the t range would be empty it makes a
  1250.  small adjustment if autoscaling is true. Otherwise, GNUPLOT
  1251.  gives an error. Such behavior may, in fact, not be very useful
  1252.  and the command `set autoscale t` is certainly questionable.
  1253.  
  1254.  `splot` extends the above idea similarly. If autoscaling is set then
  1255.  x, y, and z ranges are computed and each axis scaled to fit the
  1256.  resulting data.
  1257. 3 border
  1258. ?set border
  1259. ?set noborder
  1260. ?show border
  1261. ?border
  1262. ?noborder
  1263.  The `set border` and `set noborder` commands controls the display of
  1264.  the plot borders for the `plot` and `splot` commands.
  1265.  
  1266.  Syntax:
  1267.          set border
  1268.          set noborder
  1269.          show border
  1270. 3 clip
  1271. ?set clip
  1272. ?set noclip
  1273. ?show clip
  1274. ?clip
  1275. ?noclip
  1276.  GNUPLOT can clip data points and lines that are near the boundaries
  1277.  of a plot. 
  1278.  
  1279.  Syntax:
  1280.          set clip <clip-type>
  1281.          set noclip <clip-type>
  1282.          show clip
  1283.  
  1284.  Three clip types are supported by GNUPLOT: `points`, `one`, and `two`.
  1285.  One, two, or all three clip types may be active for a single plot.
  1286.  
  1287.  The `points` clip type forces GNUPLOT to clip (actually, not plot at
  1288.  all) data points that fall within but too close to the boundaries
  1289.  (this is so the large symbols used for points will not extend outside
  1290.  the boundary lines). Without clipping points near the boundaries may
  1291.  look bad; try adjusting the x and y ranges.
  1292.  
  1293.  Setting the `one` clip type causes GNUPLOT to plot the line segments
  1294.  which have only one of the two endpoints with the plotting region.
  1295.  Only the in-range portion of the line is drawn.  The alternative is to
  1296.  not draw any portion of the line segment.
  1297.  
  1298.  Some lines may have both endpoints out of range, but pass through the
  1299.  plotting area. Setting the `two` clip-type allows the visible portion
  1300.  of these lines to be drawn.
  1301.  
  1302.  In no case is a line drawn outside the plotting area.
  1303.  
  1304.  The defaults are `noclip points`, `clip one`, and `noclip two`.
  1305.  
  1306.  To check the state of all forms of clipping, use
  1307.          show clip
  1308.  
  1309.  For backward compatibility with older versions, the following forms
  1310.  are also permitted.
  1311.         set clip
  1312.         set noclip
  1313.  `set clip` is synonymous with `set clip points`. `set noclip` turns
  1314.  off all three types of clipping.
  1315. 3 cntrparam
  1316. ?set cntrparam
  1317. ?show cntrparam
  1318. ?cntrparam
  1319.  Sets the different parameters for the contouring plot (see also `contour`).
  1320.  
  1321.  Syntax:
  1322.          set cntrparam { { linear | cubicspline | bspline } |
  1323.                          points <n> |
  1324.                          levels <n> |
  1325.                          order <n> }
  1326.  
  1327.  This command controls the way contours are plotted. <n> should be an
  1328.  integral constant expression. The parameters are:
  1329.  
  1330.  `linear`, `cubicspline`, `bspline` - Controls type of approximation or
  1331.  interpolation. If `linear`, then the contours are drawn piecewise
  1332.  linear, as extracted from the surface directly. If `cubicspline`, then
  1333.  piecewise linear contours are interpolated to form a somewhat smoother
  1334.  contours, but which may undulate. The third option is the uniform
  1335.  `bspline`, which only approximates the piecewise linear data but is
  1336.  guaranteed to be smoother.
  1337.  
  1338.  `points` - Eventually all drawings are done with piecewise linear
  1339.  strokes.  This number controls the number of points used to
  1340.  approximate a curve.  Relevant for `cubicspline` and `bspline` modes
  1341.  only.
  1342.  
  1343.  `levels` - Number of contour levels. If the surface is bounded by zmin
  1344.  and zmax then contours will be generated from zmin+dz to zmax-dz
  1345.  in steps of size dz, where dz = (zmax - zmin) / (levels + 1).
  1346.  
  1347.  `order`  - Order of the bspline approximation to be used. The bigger this
  1348.  order is, the smoother the resulting contour.  (Of course, higher order
  1349.  bspline curves will move further away from the original peicewise linear
  1350.  data.)  This option is relevant for `bspline` mode only. Allowed values are 
  1351.  integers in the range from 2 (linear) to 10.
  1352. 3 contour
  1353. ?set contour
  1354. ?show contour
  1355. ?contour
  1356.  Enable contour drawing for surfaces. This option is available for `splot`
  1357.  only.
  1358.  
  1359.  Syntax:
  1360.          set contour { base | surface | both }
  1361.          set nocontour
  1362.  
  1363.  If no option is provided to `set contour`, the default is `base`.
  1364.  The three options specify where to draw the contours: `base` draws
  1365.  the contours on the grid base where the x/ytics are placed, `surface`
  1366.  draws the contours on the surfaces themselves, and `both` draws the
  1367.  contours on both the base and the surface.
  1368.  
  1369.  See also `set cntrparam` for the parameters that affect the drawing of 
  1370.  contours.
  1371. 3 data style
  1372. ?set data style
  1373. ?show data style
  1374. ?data style
  1375.  The `set data style` command changes the default plotting style
  1376.  for data plots.
  1377.  
  1378.  Syntax:
  1379.          set data style 
  1380.          show data style 
  1381.          set data style <style-choice>
  1382.  
  1383.  In the first case, `set data style` returns the possible style
  1384.  choices:  `lines`, `points`, `linespoints`, `dots`, `impulses`, 
  1385.  or `errorbars`.  `show data style` shows the current default
  1386.  plotting style for data.  `set data style dots` would actually 
  1387.  change the default plotting style.  See also `plot`.
  1388. 3 dummy
  1389. ?set dummy
  1390. ?show dummy
  1391. ?dummy
  1392.  By default, GNUPLOT assumes that the independent variable for the
  1393.  `plot` command is x, and the independent variables for the `splot`
  1394.  command are x and y. They are called the dummy variables because it
  1395.  is just a notation to indicate the independent variables. The `set
  1396.  dummy` command changes these default dummy variable names. For
  1397.  example, it may be more convenient to call the dummy variable t
  1398.  when plotting time functions:
  1399.  
  1400.          set dummy t
  1401.          plot sin(t), cos(t)
  1402.  
  1403.  Syntax:
  1404.          set dummy <dummy-var>{,<dummy-var>}
  1405.          show dummy
  1406.  
  1407.  Examples:
  1408.          set dummy u,v
  1409.          set dummy ,s
  1410.  
  1411.  to set both dummy variables to u and v or set only the second
  1412.  variable to s.
  1413.  
  1414.  The `set parametric` command also changes the dummy variables (to t
  1415.  for `plot` and u,v for `splot`s).
  1416.  
  1417. 3 format
  1418. ?set format
  1419. ?show format
  1420. ?format
  1421.  The format of the tic-mark labels can be set with the `set format`
  1422.  command. The default format for both axes is "%g", but other formats
  1423.  such as "%.2f" or "%3.0fm" are often desirable. Anything accepted by
  1424.  printf when given a double precision number, and then accepted by the
  1425.  terminal, will work. In particular, the formats f, e, and g will work,
  1426.  and the d, o, x, c, s, and u formats will not work.
  1427.  
  1428.  Syntax:
  1429.          set format {<axes>} {"<format-string>"}
  1430.          show format
  1431.  
  1432.  where <axes> is either `x`, `y`, `z`, `xy`, or nothing (which is the
  1433.  same as `xy`). The length of the string representing a ticmark (after
  1434.  formatting with printf) is restricted to 100 characters.  If the
  1435.  format string is omitted, the format will be returned to the default
  1436.  "%g". For LaTeX users, the format "$%g$" is often desirable.  If the
  1437.  empty string "" is used, no label will be plotted with each tic,
  1438.  though the tic mark will still be plotted. To eliminate all tic marks,
  1439.  use `set noxtics` or `set noytics`.
  1440.  
  1441.  See also `set xtics` and `set ytics` for more control over tic labels.
  1442. 3 function style
  1443. ?set function style
  1444. ?show function style
  1445. ?function style
  1446.  The `set function style` command changes the default plotting style
  1447.  for functions.
  1448.  
  1449.  Syntax:
  1450.          set function style 
  1451.          show function style 
  1452.          set function style <style-choice>
  1453.  
  1454.  In the first case, `set function style` returns the possible style
  1455.  choices:  `lines`, `points`, `linespoints`, `dots`, `impulses`, 
  1456.  or `errorbars`.  `show function style` shows the current default
  1457.  plotting style for functions.  `set function style linespoints`
  1458.  would actually change the default plotting style.  See also `plot`.
  1459. 3 functions
  1460. ?show functions
  1461.  The `show functions` command lists all user-defined functions and
  1462.  their definitions.
  1463.  
  1464.  Syntax:
  1465.          show functions
  1466. 3 grid
  1467. ?set grid
  1468. ?show grid
  1469. ?grid
  1470.  The optional `set grid` draws a grid at the tic marks with the axis
  1471.  linetype.
  1472.  
  1473.  Syntax:
  1474.          set grid
  1475.          set nogrid
  1476.          show grid
  1477. 3 hidden3d
  1478. ?set hidden3d
  1479. ?show hidden3d
  1480.  The `set hidden3d` command enables hidden line removal for explicit
  1481.  surface plotting (see `splot`).
  1482.  Hidden line removal may be used for both explicit functions
  1483.  and for explicit data where gnuplot plot is in nonparametric mode (see
  1484.  `set parametric`).
  1485.  
  1486.  When this flag is set both the surface hidden portion and possibly
  1487.  its hidden contours (see `set contour`) as well as the hidden grid will be
  1488.  removed. Labels and arrows are always visible and are unaffected by this
  1489.  command.
  1490.  
  1491.  Each surface has its hidden part removed with respect to itself, if more
  1492.  than one surface is ploted. This mode is meaningfull when surfaces are
  1493.  plotted using line style drawing only.
  1494.  
  1495.  Syntax:
  1496.          set hidden3d
  1497.          set nohidden3d
  1498.          show hidden3d
  1499. 3 isosamples
  1500. ?set isosamples
  1501. ?show isosamples
  1502. ?isosamples
  1503.  An isoline is a curve parametrized by one of the surface parameters
  1504.  while the other surface parameter is fixed. Isolines are a simple
  1505.  means to display a surface. By fixing the u parameter of surface
  1506.  s(u,v), the iso-u lines of the form c(v) = s(u0,v) are produced, and
  1507.  by fixing the v parameter, the iso-v lines of the form c(u) = s(u,v0)
  1508.  are produced.
  1509.  
  1510.  The isoline density of surfaces may be changed by the `set isosamples`
  1511.  command. By default, sampling is set to 10 isolines per u or v axis.
  1512.  A higher sampling rate will produce more accurate plots, but will take
  1513.  longer. This parameter has no effect on data file plotting.
  1514.  
  1515.  Syntax:
  1516.          set isosamples <expression>
  1517.          show isosamples
  1518. 3 key
  1519. ?set key
  1520. ?show key
  1521. ?key
  1522.  The `set key` enables a key describing curves on a plot.  By default
  1523.  the key is placed in the upper right corner of the plot.
  1524.  
  1525.  Syntax:
  1526.          set key
  1527.          set key <x>,<y>{,<z>}
  1528.          set nokey
  1529.          show key
  1530.  
  1531.  The coordinates <x>, <y> (and <z> for `splot`s) specify the location
  1532.  of the key on the plot. The key is drawn as a sequence of lines, with
  1533.  one plot described on each line. On the right hand side of each line
  1534.  is a representation that attempts to mimic the way the curve is
  1535.  plotted.  On the left side of each line is the text description,
  1536.  obtained from the `plot` command. See `plot title` to change this
  1537.  description. The lines are vertically arranged so an imaginary
  1538.  straight line divides the left- and right-hand sides of the key. It is
  1539.  the coordinates of this line that are specified with the `set key`
  1540.  command. In a `plot`, only the x and y coordinates are used to specify
  1541.  the line position.  For a `splot`, x, y and z are all being used as a
  1542.  3-d location mapped using the same mapping as the plot itself to form
  1543.  the required 2-d screen position of the imaginary line.
  1544.  
  1545.  Some or all of the key may be outside of the plot boundary, although
  1546.  this may interfere with other labels and may cause an error on some
  1547.  devices.
  1548.  
  1549.  Examples:
  1550.  
  1551.  This places the key at the default location:
  1552.          set key
  1553.  This disables the key:
  1554.          set nokey
  1555.  This places a key at coordinates 2,3.5,2
  1556.          set key 2,3.5,2
  1557. 3 label
  1558. ?set label
  1559. ?set nolabel
  1560. ?show label
  1561. ?label
  1562. ?nolabel
  1563.  Arbitrary labels can be placed on the plot using the `set label`
  1564.  command.  If the z coordinate is given on a `plot` it is ignored; if
  1565.  it is missing on a `splot` it is assumed to be 0.
  1566.  
  1567.  Syntax:
  1568.  
  1569.           set label {<tag>} {"<label_text>"} {at <x>,<y>{,<z>}}
  1570.                             {<justification>}
  1571.           set nolabel {<tag>}
  1572.           show label
  1573.  
  1574.  
  1575.  The text defaults to "", and the position to 0,0,0.  The <x>, <y>, and
  1576.  <z> values are in the graph's coordinate system.  The tag is an
  1577.  integer that is used to identify the label. If no <tag> is given, the
  1578.  lowest unused tag value is assigned automatically. The tag can be used
  1579.  to delete or change a specific label. To change any attribute of an
  1580.  existing label, use the `set label` command with the appropriate tag,
  1581.  and specify the parts of the label to be changed.
  1582.  
  1583.  By default, the text is placed flush left against the point x,y,z.
  1584.  To adjust the way the label is positioned with respect to the point
  1585.  x,y,z, add the parameter <justification>, which may be `left`, `right`
  1586.  or `center`, indicating that the point is to be at the left, right or
  1587.  center of the text. Labels outside the plotted boundaries are
  1588.  permitted but may interfere with axes labels or other text.
  1589.  
  1590.  Examples:
  1591.  
  1592.  To set a label at (1,2) to "y=x" use:
  1593.           set label "y=x" at 1,2
  1594.  To set a label "y=x^2" with the right of the text at (2,3,4), and tag
  1595.  the label number 3, use:
  1596.           set label 3 "y=x^2" at 2,3,4 right
  1597.  To change the preceding label to center justification, use:
  1598.           set label 3 center
  1599.  To delete label number 2 use:
  1600.           set nolabel 2
  1601.  To delete all labels use:
  1602.           set nolabel
  1603.  To show all labels (in tag order) use:
  1604.           show label
  1605.  
  1606.  (The Latex, EEPIC, and Imagen drivers allow \\ in a string to specify
  1607.  a newline.)
  1608. 3 logscale
  1609. ?set logscale
  1610. ?set nologscale
  1611. ?show logscale
  1612. ?logscale
  1613. ?nologscale
  1614.  Log scaling may be set on the x, y, and z axes.
  1615.  
  1616.  Syntax:
  1617.          set logscale <axes>
  1618.          set nologscale <axes>
  1619.          show logscale
  1620.  
  1621.  where <axes> may be any combinations of `x`, `y`, and `z`, in any
  1622.  order.  If <axes> is not given then all three axes are assumed.  The
  1623.  command `set logscale` turns on log scaling on the specified axes,
  1624.  while `set nologscale` turns off log scaling.
  1625.  
  1626.  Examples:
  1627.  
  1628.  To enable log scaling in both x and z axes:
  1629.         set logscale xz
  1630.  To disable z axis log scaling:
  1631.         set nologscale z
  1632. 3 mapping
  1633. ?set mapping
  1634. ?show mapping
  1635. ?mapping
  1636.  
  1637.  Syntax:
  1638.          set mapping { cartesian | spherical | cylindrical }
  1639.  
  1640.  Data for `splot`s are usually in regular Euclidean space and are
  1641.  provided in Cartesian coordinates. Such 3-d data require three
  1642.  coordinates (x, y and z) or one coordinate (only z) in each line in
  1643.  the data file.  In order to be able to use spherical or cylindrical
  1644.  coordinate systems, use the `set mapping` command. In both cases two
  1645.  coordinates are expected in each line of the data. For a spherical
  1646.  coordinate system, these are theta and phi (in units as specified by
  1647.  `set angles`) and the mapping is:
  1648.  
  1649.          x = cos( theta ) * cos( phi )
  1650.          y = sin( theta ) * cos( phi )
  1651.          z = sin( phi )
  1652.  
  1653.  For a cylindrical coordinate system, the mapping uses two variables,
  1654.  theta (in units as specified by `set angles`) and z:
  1655.  
  1656.          x = cos( theta )
  1657.          y = sin( theta )
  1658.          z = z
  1659.  
  1660.  Again, note that mapping will affect data file `splot`s only.
  1661. 3 offsets
  1662. ?set offsets
  1663. ?show offsets
  1664. ?offsets
  1665.  The amount of the graph that the plot takes up may be controlled to
  1666.  some extent with the `set offsets` command. This command takes four
  1667.  offset arguments: <left>, <right>, <top> and <bottom>. By default,
  1668.  each offset is 0. Each offset may be a constant or an expression. Left
  1669.  and right offsets are given in units of the x axis, while top and
  1670.  bottom offsets are given in units of the y axis. The plot of sin(x),
  1671.  displayed with offsets of 0, 0, 2, 2 will take up 1/3 of the
  1672.  displayed y axis. Offsets are particularly useful with polar
  1673.  coordinates as a means of compensating for aspect ratio distortion.
  1674.  Offsets are ignored in `splot`s.
  1675.  
  1676.  Syntax:
  1677.          set offsets <left>, <right>, <top>, <bottom>
  1678.          show offsets
  1679. 3 output
  1680. ?set output
  1681. ?show output
  1682. ?output
  1683.  By default, plots are displayed to the standard output. The `set
  1684.  output` command redirects the display to the specified file or
  1685.  device.
  1686.  
  1687.  Syntax:
  1688.          set output {"<filename>"}
  1689.          show output
  1690.  
  1691.  The filename must be enclosed in quotes. If the filename is
  1692.  omitted, output will be sent to the standard output.
  1693.  
  1694.  On machines with popen functions (UNIX), output can be piped
  1695.  through a shell command if the first letter of the filename
  1696.  is '|'.  For instance,
  1697.  
  1698.  Syntax:
  1699.          set output "|lpr -Plaser filename"
  1700.          set output "|lp -dlaser filename"
  1701.  
  1702.  (On MSDOS machines, set output "prn" will direct the output
  1703.  to the default printer.)
  1704.  
  1705. 3 parametric
  1706. ?set parametric
  1707. ?set noparametric
  1708. ?show parametric
  1709. ?parametric
  1710. ?noparametric
  1711.  The `set parametric` command changes the meaning of `plot` (`splot`)
  1712.  from normal functions to parametric functions. The command
  1713.  `set noparametric` changes the plotting style back to normal,
  1714.  single-valued expression plotting.
  1715.  
  1716.  In 2-d plotting, a parametric function is determined by a pair
  1717.  of parametric functions operating on a parameter. An example
  1718.  of a 2-d parametric function would be plot sin(t),cos(t) (which
  1719.  defines a circle).
  1720.  
  1721.  For 3-d plotting, the surface is described as x=f(u,v), y=g(u,v),
  1722.  z=h(u,v). Therefore a triplet of functions are required. An example of
  1723.  3-d parametric function would be cos(u)*cos(v),cos(u)*sin(v),sin(u)
  1724.  (which defines a sphere). It takes three parametric function
  1725.  specifications in terms of the parametric dummy arguments to describe
  1726.  a single graph.
  1727.  
  1728.  The total set of possible plots is a superset of the simple f(x)
  1729.  style plots, since the two (three) functions can describe the
  1730.  x and y (and z) values to be computed separately. In fact,
  1731.  plots of the type t,f(t) (u,v,f(u,v)) are equivalent to those
  1732.  produced with f(x) when the x values are computed using the
  1733.  identity function as the first function.
  1734.  
  1735.  Note that the order the parametric functions are specified is
  1736.  xfunction, yfunction (and zfunction) and that each operates over the
  1737.  common parametric domain.
  1738.  
  1739.  Also, the `set parametric` function implies a new range of values.
  1740.  Whereas the normal f(x) and f(x,y) style plotting assume an xrange
  1741.  and yrange (and zrange), the parametric mode additionally specifies a
  1742.  trange, urange, and vrange. These ranges may be set
  1743.  directly with `set trange`, `set urange` and `set vrange`, or by
  1744.  specifying the range on the `plot` or `splot` commands. Currently
  1745.  the default range for these parametric variables is [-5:5].
  1746.  Setting the ranges to something more meaningful is expected.
  1747. 3 polar
  1748. ?set polar
  1749. ?set nopolar
  1750. ?show polar
  1751. ?polar
  1752. ?nopolar
  1753.  The `set polar` command changes the meaning of the plot from
  1754.  rectangular coordinates to polar coordinates. In polar coordinates,
  1755.  the dummy variable (x) is an angle. The range of this angle is changed
  1756.  from whatever it was to [0:2*pi], or, if degree unit has been selected,
  1757.  to [0:360] (see `set angles`).
  1758.  
  1759.  The command `set nopolar` changes the meaning of the plot back to the
  1760.  default rectangular coordinate system. The range of x is changed from
  1761.  whatever it was to [-10:10].
  1762.  
  1763.  The `set polar` command is not supported for `splot`s.  See the
  1764.  `set mapping` command for similar functionality for `splot`s.
  1765.  
  1766.  While in polar coordinates the meaning of an expression in x is really
  1767.  r = f(x), where x is an angle of rotation. The xrange controls the
  1768.  domain (the angle) of the function, and the yrange controls the range
  1769.  (the radius). The plot is plotted in a rectangular box, and the x and
  1770.  y axes are both in units of the radius. Thus, the yrange controls both
  1771.  dimensions of the plot output. The tics and units are written along
  1772.  the axes rather than at the left and bottom. These unit are offset by
  1773.  <rmin> specified by the `rrange` (See `set rrange`). It is not
  1774.  possible to specify different output dimensions in the x or y
  1775.  directions. The yrange can be used to shift the plot diagonally to
  1776.  display only the first or third quadrants.
  1777.  
  1778.  Syntax:
  1779.          set polar
  1780.          set nopolar
  1781.          show polar
  1782.  Example:
  1783.          set polar
  1784.          plot x*sin(x)
  1785.          plot [-2*pi:2*pi] [-3:3] x*sin(x)
  1786.  The first plot uses the default polar angular domain of 0 to 2*pi.
  1787.  The radius (and the size of the plot) is scaled automatically. The
  1788.  second plot expands the domain, and restricts the range of the radius
  1789.  (and the size of the plot) to [-3:3].
  1790. 3 rrange
  1791. ?set rrange
  1792. ?show rrange
  1793. ?rrange
  1794.  The `set rrange` command sets the radial range used to compute x and y
  1795.  values when in polar mode. If not in polar mode (see `set polar`) then
  1796.  this range is not used. Use of this command offsets the polar
  1797.  singularity to the <rmin> value and shifts the units on the axes tic
  1798.  marks. For instance, `set rrange [-40:40]` would set the origin to -40
  1799.  and would plot values of radial values between -40 to 40. Thus, if
  1800.  360 degrees of data were plotted, then the plot would extend 80 units
  1801.  in radially from the origin.  To view the entire plot,  a 
  1802.  `set yrange [-80:80]` command would create a square viewport with
  1803.  a circular plot tangent at the axes.  Because `xrange` is used
  1804.  specify the angular extent, only a square viewport can be specified
  1805.  by `yrange`.  For instance, `set yrange [0:80]` would display the
  1806.  first quadrant and `set yrange [-80:0]` would display the third
  1807.  quadrant.  Any square viewport of any size can be specified but it
  1808.  is constrained to be centered on a 45 degree line.
  1809.  
  1810.  This range may also be specified on the `plot` command line when in
  1811.  polar mode.
  1812.  
  1813.  Syntax:
  1814.          set rrange [{<rmin> : <rmax>}]
  1815.  
  1816.  where <rmin> and <rmax> terms are constants or expressions.
  1817.  
  1818.  Both the <rmin> and <rmax> terms are optional. Anything omitted will
  1819.  not be changed, so 
  1820.          set rrange [:10]
  1821.  changes rmax to 10 without affecting rmin.
  1822. 3 samples
  1823. ?set samples
  1824. ?show samples
  1825. ?samples
  1826.  The sampling rate of functions may be changed by the `set samples`
  1827.  command. By default, sampling is set to 100 points. A higher sampling
  1828.  rate will produce more accurate plots, but will take longer. This
  1829.  parameter no longer has any effect on data-file plotting.
  1830.  
  1831.  Syntax:
  1832.          set samples <expression>
  1833.          show samples
  1834. 3 size
  1835. ?set size
  1836. ?show size
  1837. ?size
  1838.  The `set size` command scales the displayed size of the plot.  On some
  1839.  terminals, changing the size of the plot will result in text being
  1840.  misplaced. Increasing the size of the plot may produce strange
  1841.  results. Decreasing is safer.
  1842.  
  1843.  Syntax:
  1844.  
  1845.          set size {<xscale>,<yscale>}
  1846.          show size
  1847.  
  1848.  The <xscale> and <yscale> values are the scaling factors for the size.
  1849.  The defaults (1,1) are selected if the scaling factors are omitted.
  1850.  
  1851.  Examples: 
  1852.  
  1853.  To set the size to normal size use:
  1854.          set size
  1855.  To make the plot half size use:
  1856.          set size 0.5,0.5
  1857.  To make a landscape plot have a 1:1 aspect ratio in polar mode use:
  1858.          set size 0.721,1.0
  1859.  To show the size use:
  1860.          show size
  1861.  
  1862.  For the LaTeX and Fig terminals the default size (scale factor 1,1)
  1863.  is 5 inches wide by 3 inches high. The big Fig terminal (`bfig`) is 7
  1864.  inches wide by 5 inches high. The postscript default is landscape mode
  1865.  10 inches wide and 7 inches high. 
  1866.  Note that the size of the plot includes the space used by the labels; 
  1867.  the plotting area itself is smaller. 
  1868. 3 style
  1869. ?set style
  1870. ?show style
  1871. ?style
  1872.  Plots may be displayed in one of six styles: `lines`, `points`,
  1873.  `linespoints`, `impulses`, `dots`, or `errorbars`. The `lines` style
  1874.  connects adjacent points with lines. The `points` style displays a
  1875.  small symbol at each point. The `linespoints` style does both
  1876.  `lines` and `points`. The `impulses` style displays a vertical line
  1877.  from the x axis to each point. The `dots` style plots a tiny dot at
  1878.  each data point; this is useful for scatter plots with many points.
  1879.  
  1880.  The `errorbars` style is relevant only for to data file `plot`s. It is
  1881.  treated like `points` for function `plot`s and `splot`s. For data file
  1882.  `plot`s, `errorbars` is like `points`, except that a vertical error
  1883.  bar is also drawn: for each point (x,y), a line is drawn from (x,ylow)
  1884.  to (x,yhigh). A tic mark is placed at the ends of the error bar. The
  1885.  ylow and yhigh values are read from the data file's third and fourth
  1886.  columns, or as specified with the `using` option to plot.  See `plot
  1887.  errorbars` for more information.
  1888.  
  1889.  Default styles are chosen with the `set function style` and `set
  1890.  data style` commands. See `plot style` for information about how
  1891.  to override the default plotting style for individual functions.
  1892.  
  1893.  Syntax:
  1894.          set function style <style>
  1895.          set data style <style>
  1896.          show function style
  1897.          show data style
  1898.  
  1899.  where <style> is `lines`, `points`, `linespoints`, `impulses`,
  1900.  `dots`, or `errorbars`.
  1901. 3 surface
  1902. ?set surface
  1903. ?set nosurface
  1904. ?show surface
  1905. ?surface
  1906.  `set surface` controls the display of surfaces. It is useful if
  1907.  contours are to be displayed by themselves. Whenever `set nosurface`
  1908.  is issued, no surface isolines/mesh will be drawn. See also `set
  1909.  contour`.
  1910.  
  1911.  Syntax:
  1912.          set surface
  1913.          set nosurface
  1914.          show surface
  1915. 3 terminal
  1916. ?set terminal
  1917. ?show terminal
  1918. ?terminal
  1919.  GNUPLOT supports many different graphics devices. Use the `set
  1920.  terminal` command to select the type of device for which GNUPLOT
  1921.  will produce output.
  1922.  
  1923.  Syntax:
  1924.          set terminal {<terminal-type>}
  1925.          show terminal
  1926.  
  1927.  If <terminal-type> is omitted, GNUPLOT will list the available
  1928.  terminal types. <terminal-type> may be abbreviated.
  1929.  
  1930.  Use `set output` to redirect this output to a file or device.
  1931.  
  1932.  Several terminals have additional options. For example, see `dumb`,
  1933.  `iris4d`, `hpljii` or `postscript`.
  1934. 4 dumb
  1935. ?set terminal dumb
  1936. ?dumb
  1937.  The dumb terminal driver has an optional size specification.
  1938.  
  1939.  Syntax:
  1940.          set terminal dumb {<xsize> <ysize>}
  1941.  
  1942.  where <xsize> and <ysize> set the size of the dumb terminals. Default
  1943.  is 79 by 24.
  1944.  
  1945.  Examples:
  1946.          set term dumb
  1947.          set term dumb 79 49 #(VGA screen - why would anyone want to do that!?)
  1948.  
  1949. 4 hpljii
  1950. ?set terminal hpljii
  1951. ?hpljii
  1952.  The HP LaserJet II and HP DeskJet drivers have a single option.
  1953.  
  1954.  Syntax:
  1955.          set terminal hpljii {<resolution>}
  1956.          set terminal hpdj   {<resolution>}
  1957.  
  1958.  where <resolution> is the resolution of the output in dots per inch.
  1959.  It must be `75`, `100`, `150` or `300`.
  1960.  
  1961.  Example:
  1962.          set terminal hpljii 150
  1963.  
  1964. 4 iris4d
  1965. ?set terminal iris4d
  1966. ?iris4d
  1967.  The iris4d driver can operate in two modes.
  1968.  
  1969.  Syntax:
  1970.          set terminal iris4d {24}
  1971.  
  1972.  If the hardware supports only 8 bits, use the default `set terminal
  1973.  iris4d`. If, however, the hardware supports 24 bits (8 per
  1974.  red/green/blue), use `set terminal iris4d 24`.
  1975.  
  1976.  When using 24-bit mode, the colors can be directly specified via the
  1977.  file .gnuplot_iris4d that is searched in the current directory and
  1978.  then in the home directory specified by the HOME environment variable.
  1979.  This file holds RGB values for the background, border, labels and nine
  1980.  plotting colors, in that order. For example, here is a file containing
  1981.  the default colors:
  1982.  
  1983.          85   85   85     /* Back Ground */
  1984.          0    0    0      /* Boundary */
  1985.          170  0    170    /* Labeling */
  1986.          85   255  255    /* Plot Color 1 */
  1987.          170  0    0      /* Plot Color 2 */
  1988.          0    170  0      /* Plot Color 3 */
  1989.          255  85   255    /* Plot Color 4 */
  1990.          255  255  85     /* Plot Color 5 */
  1991.          255  85   85     /* Plot Color 6 */
  1992.          85   255  85     /* Plot Color 7 */
  1993.          0    170  170    /* Plot Color 8 */
  1994.          170  170  0      /* Plot Color 9 */
  1995.  
  1996.  This file has exactly 12 lines of RGB triples. No empty lines are
  1997.  allowed and anything after the third number in line is ignored.
  1998.  
  1999. 4 pbm
  2000. ?set terminal pbm
  2001. ?pbm
  2002.  Several options may be set in the PBMplus driver.
  2003.  
  2004.  Syntax:
  2005.          set terminal pbm {<fontsize>}
  2006.          set terminal pgm {<fontsize>}
  2007.          set terminal ppm {<fontsize>}
  2008.  
  2009.  where <fontsize> is `small`, `medium`, or `large`. 
  2010.  Default size is 640 pixels wide and 480 pixels high.
  2011.  The pbm output is a portable bitmap (one bit per pixel).
  2012.  The pgm output is a portable graymap (three bits per pixel).     
  2013.  The ppm output is a portable pixmap (color, four bits per pixel).
  2014.  The output of these drivers can be used with Jef Poskanzer's 
  2015.  excellent PBMPLUS package which provides programs to convert
  2016.  the above PBMPLUS formats to GIF, TIFF, MacPaint, Macintosh PICT,
  2017.  PCX, X11 bitmap and many others. 
  2018.  
  2019.  Examples:
  2020.  
  2021.          set term pbm small
  2022.          set size 2,2
  2023.          set term ppm medium
  2024.  
  2025. 4 postscript
  2026. ?set terminal postscript
  2027. ?postscript
  2028.  Several options may be set in the PostScript driver.
  2029.  
  2030.  Syntax:
  2031.          set terminal postscript {<mode>} {<color>}
  2032.                                  {"<fontname>"} {<fontsize>}
  2033.  
  2034.  where <mode> is `landscape`, `portrait`, `eps` or `default`. 
  2035.  Selecting default sets all options to their defaults.
  2036.  <color> is either `color` or `monochrome`.
  2037.  "<fontname>" is the name of a valid PostScript font.
  2038.  <fontsize> is the size of the font in PostScript points, before 
  2039.  scaling by the `set size` command.
  2040.  Defaults are `landscape`, `monochrome`, "Courier", and 14pt.
  2041.  Default size of PostScript plot is landscape mode 10 inches wide 
  2042.  and 7 inches high.
  2043.  
  2044.  To get EPS output, use the `eps` mode and make only one plot per file.
  2045.  In `eps` mode the whole plot is halved in size; the fonts are half the 
  2046.  given size, and the plot is 5 inches wide and 3.5 inches high.
  2047.  
  2048.  Examples:
  2049.  
  2050.          set term postscript default       # old postscript
  2051.          set term postscript landscape 22  # old psbig
  2052.          set term postscript eps 14   # old epsf1
  2053.          set term postscript eps 22   # old epsf2
  2054.          set size 0.7,1.4
  2055.          set term post portrait color "Times-Roman" 14 
  2056.  
  2057. 4 aifm
  2058. ?set terminal aifm
  2059. ?aifm
  2060.  Several options may be set in the Adobe Illustrator 3.0 driver.
  2061.  
  2062.  Syntax:
  2063.          set terminal aifm {<color>}
  2064.                                  {"<fontname>"} {<fontsize>}
  2065.  
  2066.  Selecting default sets all options to their defaults.
  2067.  <color> is either `color` or `monochrome`.
  2068.  "<fontname>" is the name of a valid PostScript font.
  2069.  <fontsize> is the size of the font in PostScript points, before 
  2070.  scaling by the `set size` command.
  2071.  Defaults are `monochrome`, "Courier", and 14pt.
  2072.  
  2073.  Also, since AI does not really support multiple pages, multiple 
  2074.  graphs will be output directly on one another.  However, each graph 
  2075.  will be grouped individually, making it easy to separate them inside 
  2076.  AI (just pick them up and move them).
  2077.  
  2078.  Examples:
  2079.  
  2080.          set term aifm 
  2081.          set term aifm 22  
  2082.          set size 0.7,1.4
  2083.          set term aifm color "Times-Roman" 14 
  2084.  
  2085. 4 table
  2086. ?set terminal table
  2087. ?table
  2088.  Instead of producing a picture, term type 'table' prints out
  2089.  the evaluation results in a multicolumn ASCII table of X Y Z values.
  2090.  For those times when you really want to see the numbers, now you
  2091.  can see them on the screen or save to a file.
  2092.  
  2093. 3 tics
  2094. ?set tics
  2095. ?show tics
  2096. ?tics
  2097.  By default, tics are drawn inwards from the border on all four sides.
  2098.  The `set tics` command can be used to change the tics to be 
  2099.  drawn outwards on the left and bottom borders only.
  2100.  This is useful when doing impulse plots.
  2101.  
  2102.  Syntax:
  2103.          set tics {<direction>}
  2104.          show tics
  2105.  
  2106.  where <direction> may be `in` or `out`. `set tics` defaults to `in`.
  2107.  
  2108.  See also the `set xtics`, `set ytics`, and `set ztics` command for more
  2109.  control of tic marks.
  2110. ?set ticslevel
  2111. ?show ticslevel
  2112. ?ticslevel
  2113.  Using splot, in 3-d plots, one can adjust the relative height of the
  2114.  vertical (Z) axis using `set ticslevel`. The numeric argument provided
  2115.  specifies the location of the bottom of the scale. a zero will put it
  2116.  on the bottom grid and any positive number somewhere along the z axis.
  2117.  
  2118.  Syntax:
  2119.          set ticslevel {<level>}
  2120.          show tics
  2121.  
  2122.  where <level> is a non negative numeric argument. For example,
  2123.  
  2124.          set ticslevel 0.5
  2125.  
  2126.  sets the tics level to the default value.
  2127.  
  2128.  See also the `set view`.
  2129. 3 time
  2130. ?set time
  2131. ?show time
  2132. ?time
  2133.  The optional `set time` places the time and date of the plot either
  2134.  at the top or bottom of the left margin. The exact location is
  2135.  device dependent.
  2136.  
  2137.  Syntax:
  2138.          set time {<xoff>}{,<yoff>}
  2139.          set notime
  2140.          show time
  2141.  
  2142.  Specifying constants <xoff> or <yoff> as optional offsets for the time
  2143.  will move the time <xoff> or <yoff> character screen coordinates. For
  2144.  example,
  2145.  
  2146.          set time ,-3
  2147.  
  2148.  will change only the y offset of the time, moving the title down by
  2149.  roughly the height of three characters.
  2150.  
  2151. 3 title
  2152. ?set title
  2153. ?show title
  2154. ?title
  2155.  The `set title` command produces a plot title that is centered at the
  2156.  top of the plot. Using the optional x,y screen offsets, the title
  2157.  can be placed anywhere on the plot. `set title` with no parameters
  2158.  clears the title.
  2159.  
  2160.  Syntax:
  2161.           set title {"<title-text>"} {<xoff>}{,<yoff>}
  2162.           show title
  2163.  
  2164.  Specifying constants <xoff> or <yoff> as optional offsets for the
  2165.  title will move the title <xoff> or <yoff> character screen
  2166.  coordinates. Note these are screen coordinates and not plot
  2167.  coordinates. For example,
  2168.  
  2169.           set title ,-1
  2170.  
  2171.  will change only the y offset of the title, moving the title down by
  2172.  roughly the height of one character.
  2173.  
  2174.  (The Latex, EEPIC, and Imagen drivers allow \\ in a string to specify
  2175.  a newline.)
  2176. 3 trange
  2177. ?set trange
  2178. ?show trange
  2179. ?trange
  2180.  The `set trange` command sets the parametric range used to compute
  2181.  x and y values when in parametric mode. If not in parametric mode
  2182.  (see `set parametric`) then this range is not used. This command
  2183.  does not affect x/y autoscaling or x/y ranges.
  2184.  
  2185.  This range may also be specified on the `plot` command line when
  2186.  in parametric mode.
  2187.  
  2188.  Syntax:
  2189.          set trange [{<tmin> : <tmax>}]
  2190.  
  2191.  where <tmin> and <tmax> terms are constants or expressions.
  2192.  
  2193.  Both the <tmin> and <tmax> terms are optional. Anything omitted will
  2194.  not be changed, so 
  2195.          set trange [:10]
  2196.  changes tmax to 10 without affecting tmin.  See also `set urange` and
  2197.  `set parametric`.
  2198. 3 urange
  2199. ?set urange
  2200. ?show urange
  2201. ?urange
  2202.  The `set urange` and `set vrange` commands sets the parametric ranges used 
  2203.  to compute x, y, and z values when in `splot` parametric mode. If not in 
  2204.  parametric mode (see `set parametric`) then these ranges are not used. This 
  2205.  command does not affect x/y autoscaling or x/y ranges.
  2206.  
  2207.  This range may also be specified on the `splot` command line when
  2208.  in parametric mode.  See `plot` for more information
  2209.  
  2210.  Syntax:
  2211.          set urange [{<umin> : <umax>}]
  2212.  
  2213.  where <umin> and <umax> terms are constants or expressions.
  2214.  
  2215.  Both the <umin> and <umax> terms are optional. Anything omitted will
  2216.  not be changed, so 
  2217.          set urange [:10]
  2218.  changes umax to 10 without affecting umin.  See also `set trange`.
  2219. 3 variables
  2220. ?show variables
  2221.  The `show variables` command lists all user-defined variables and
  2222.  their values.
  2223.  
  2224.  Syntax:
  2225.          show variables
  2226. 3 view
  2227. ?set view
  2228. ?show view
  2229. ?view
  2230.  The `set view` command sets the view point for `splot`s. This
  2231.  command controls the way the 3-d coordinates of the plot are mapped
  2232.  into the 2-d screen space. This command provides controls to both
  2233.  rotation and scaling of the plotted data but supports orthographic
  2234.  projections only.
  2235.  
  2236.  Syntax:
  2237.          set view <rot_x> {,{<rot_z>}{,{<scale>}{,<scale_z>}}}
  2238.          show view
  2239.  
  2240.  where <rot_x> and <rot_z> control the rotation angles (in degrees)
  2241.  along a virtual 3-d coordinate system aligned with the screen such
  2242.  that the screen horizontal axis is x, screen vertical axis is y, and
  2243.  the axis perpendicular to the screen is z. <rot_x> is bounded to the
  2244.  [0:180] range with a default of 60 degrees, while <rot_z> is bounded
  2245.  to the [0:360] range with a default of 30 degrees. <scale> controls
  2246.  the scaling of the entire `splot`, while <scale_z> scales the z axis
  2247.  only. Both scales default to 1.0.
  2248.  
  2249.  Examples:
  2250.          set view 60, 30, 1, 1
  2251.          set view ,,0.5
  2252.  
  2253.  The first sets all the four default values. The second changes 
  2254.  only scale, to 0.5.
  2255.  
  2256.  See also `set ticslevel`.
  2257. 3 vrange
  2258. ?set vrange
  2259. ?show vrange
  2260. ?vrange
  2261.  The `set vrange` command is similar to the `set urange` command.
  2262.  Please see `set urange`.
  2263. 3 xlabel
  2264. ?set xlabel
  2265. ?show xlabel
  2266. ?xlabel
  2267.  The `set xlabel` command sets the x-axis label that is centered along
  2268.  the x axis. Using the optional x,y screen offsets, the label can be
  2269.  placed anywhere on the plot. `set xlabel` with no parameters clears
  2270.  the label.
  2271.  
  2272.  Syntax: 
  2273.           set xlabel {"<label>"} {<xoff>}{,<yoff>}
  2274.           show xlabel
  2275.  
  2276.  Specifying constants <xoff> or <yoff> as optional offsets for the
  2277.  label will move the label <xoff> or <yoff> character screen
  2278.  coordinates. For example,
  2279.  
  2280.           set xlabel -1
  2281.  
  2282.  will change only the x offset of the xlabel, moving the label roughly
  2283.  one character width to the left.
  2284.  
  2285.  (The LaTeX, EEPIC, and Imagen drivers allow \\ in a string to specify
  2286.  a newline.)
  2287. 3 xrange
  2288. ?set xrange
  2289. ?show xrange
  2290. ?xrange
  2291.  The `set xrange` command sets the horizontal range that will be
  2292.  displayed. This command turns x axis autoscaling off.
  2293.  
  2294.  This range may also be specified on the `plot` command line.
  2295.  
  2296.  Syntax:
  2297.          set xrange [{<xmin> : <xmax>}]
  2298.  
  2299.  where <xmin> and <xmax> terms are constants or expressions.
  2300.  
  2301.  Both the <xmin> and <xmax> terms are optional. Anything omitted will
  2302.  not be changed, so 
  2303.          set xrange [:10]
  2304.  changes xmax to 10 without affecting xmin.
  2305. 3 xtics
  2306. ?set xtics
  2307. ?set noxtics
  2308. ?show xtics
  2309. ?xtics
  2310. ?noxtics
  2311.  Fine control of the x axis tic marks is possible with the
  2312.  `set xtics` command. The x-axis tic marks may be turned off with the
  2313.  `set noxtics` command. They may be turned on (the default state) with
  2314.  `set xtics`.
  2315.  
  2316.  Syntax:
  2317.           set xtics { {<start>, <incr>{, <end>}} |
  2318.                       {({"<label>"} <pos> {, {"<label>"} <pos>}...)} }
  2319.           set noxtics
  2320.           show xtics
  2321.  
  2322.  The <start>, <incr>, <end> form specifies that a series of tics will
  2323.  be plotted on the x axis between the x values <start> and <end>
  2324.  with an increment of <incr>. If <end> is not given it is assumed to be
  2325.  infinity. The increment may be negative. For example,
  2326.            set xtics 0,.5,10
  2327.  makes tics at 0, 0.5, 1, 1.5, ..., 9.5, 10.
  2328.  
  2329.  The ("<label>" <pos>, ...) form allows arbitrary tic positions or
  2330.  non-numeric tic labels. A set of tics are a set of positions, each
  2331.  with its own optional label. Note that the label is a string enclosed
  2332.  by quotes, and may be a constant string, such as "hello", or contain
  2333.  formatting information for the tic number (which is the same as the
  2334.  position), such as "%3f clients". See `set format` for more
  2335.  information about this case. The label may even be empty.
  2336.  Examples:
  2337.           set xtics ("low" 0, "medium" 50, "high" 100)
  2338.           set xtics (1,2,4,8,16,32,64,128,256,512,1024)
  2339.           set xtics ("bottom" 0, "" 10, "top" 20)
  2340.  
  2341.  Tics will only be plotted when in range.
  2342.  
  2343.  The `set ytics` and `set noytics` commands work identically.
  2344.  See also the `set format` command.
  2345. 3 xzeroaxis
  2346. ?set xzeroaxis
  2347. ?set noxzeroaxis
  2348. ?show xzeroaxis
  2349. ?xzeroaxis
  2350. ?noxzeroaxis
  2351.  `set xzeroaxis` draws the x-axis. By default, this option is on.
  2352.  `set noxzeroaxis` causes GNUPLOT to omit the x-axis.
  2353.  
  2354.  Syntax:
  2355.          set xzeroaxis
  2356.          set noxzeroaxis
  2357.          show xzeroaxis
  2358. 3 ylabel
  2359. ?set ylabel
  2360. ?show ylabel
  2361. ?ylabel
  2362.  The `set ylabel` command sets the y-axis label.  The position of this
  2363.  label depends on the terminal, and can be one of the following three
  2364.  positions (the position can be adjusted with optional parameters).
  2365.  
  2366.  1. Horizontal text flushed left at the top left of the plot.
  2367.  Terminals that cannot rotate text will probably use this method.
  2368.  
  2369.  2. Vertical text centered vertically at the left of the plot.
  2370.  Terminals that can rotate text will probably use this method.
  2371.  
  2372.  3. Horizontal text centered vertically at the left of the plot.
  2373.  The LaTeX and EEPIC drivers use this method. The user must insert 
  2374.  line breaks using \\ to prevent the ylabel from overwriting
  2375.  the plot. To produce a vertical row of characters, add \\
  2376.  between every printing character (but this is ugly).
  2377.  
  2378.  Syntax:  
  2379.           set ylabel {"<label>"} {<xoff>}{,<yoff>}
  2380.           show ylabel
  2381.  
  2382.  With no parameters, the label is cleared. Specifying constants <xoff>
  2383.  or <yoff> as optional offsets for the label will move the label <xoff>
  2384.  or <yoff> character screen coordinates. For example,
  2385.  
  2386.           set ylabel -1
  2387.  
  2388.  will change only the x offset of the ylabel, moving the label roughly
  2389.  one character width left of its default position. This is especially
  2390.  useful with the LaTeX driver.
  2391.  
  2392.  (The LaTeX, EEPIC, and Imagen drivers allow \\ in a string to specify
  2393.  a newline.)
  2394. 3 yrange
  2395. ?set yrange
  2396. ?show yrange
  2397. ?yrange
  2398.  The `set yrange` command sets the vertical range that will be
  2399.  displayed. This command turns y axis autoscaling off.
  2400.  
  2401.  This range may also be specified on the `plot` command line.
  2402.  
  2403.  Syntax:
  2404.          set yrange [{<ymin> : <ymax>}]
  2405.  
  2406.  where <ymin> and <ymax> terms are constants or expressions.
  2407.  
  2408.  Both the <ymin> and <ymax> terms are optional. Anything omitted will
  2409.  not be changed, so 
  2410.          set yrange [:10]
  2411.  changes ymax to 10 without affecting ymin.
  2412. 3 ytics
  2413. ?set ytics
  2414. ?set noytics
  2415. ?show ytics
  2416. ?ytics
  2417. ?noytics
  2418.  The `set ytics` and `set noytics` commands are similar to the `set xtics`
  2419.  and `set noxtics` commands. Please see `set xtics`.
  2420. 3 yzeroaxis
  2421. ?set yzeroaxis
  2422. ?set noyzeroaxis
  2423. ?show yzeroaxis
  2424. ?yzeroaxis
  2425. ?noyzeroaxis
  2426.  `set yzeroaxis` draws the y-axis. By default, this option is on.
  2427.  `set noyzeroaxis` causes GNUPLOT to omit the y-axis.
  2428.  
  2429.  Syntax:
  2430.          set yzeroaxis
  2431.          set noyzeroaxis
  2432.          show yzeroaxis
  2433. 3 zero
  2434. ?set zero
  2435. ?show zero
  2436. ?zero
  2437.  The `zero` value is the default threshold for values approaching 0.0.
  2438.  GNUPLOT will not plot a point if its imaginary part is greater in
  2439.  magnitude than the `zero` threshold. Axis ranges cannot be less than
  2440.  `zero`. The default `zero` value is 1e-8. This can be changed with
  2441.  the `set zero` command.
  2442.  
  2443.  Syntax:
  2444.          set zero <expression>
  2445.          show zero
  2446. 3 zeroaxis
  2447. ?set zeroaxis
  2448. ?set nozeroaxis
  2449. ?show zeroaxis
  2450. ?zeroaxis
  2451. ?nozeroaxis
  2452.  `set zeroaxis` draws the x-axis and y-axis. By default, this option is
  2453.  on.  `set nozeroaxis` causes GNUPLOT to omit the axes, and is
  2454.  equivalent to `set noxzeroaxis; set noyzeroaxis.`
  2455.  
  2456.  Syntax:
  2457.          set zeroaxis
  2458.          set nozeroaxis
  2459.          show zeroaxis
  2460.  See `set xzeroaxis` and `set yzeroaxis`.
  2461. 3 zlabel
  2462. ?set zlabel
  2463. ?show zlabel
  2464. ?zlabel
  2465.  The `set zlabel` command sets the z-axis label that is centered along
  2466.  the z axis. Using the optional x,y screen offsets, the label can be
  2467.  placed anywhere on the plot. `set zlabel` with no parameters clears
  2468.  the label.
  2469.  
  2470.  Syntax: 
  2471.           set zlabel {"<label>"} {<xoff>}{,<yoff>}
  2472.           show zlabel
  2473.  
  2474.  Specifying constants <xoff> or <yoff> as optional offsets for the
  2475.  label will move the label <xoff> or <yoff> character screen
  2476.  coordinates. For example,
  2477.  
  2478.           set zlabel ,1
  2479.  
  2480.  will change only the y offset of the zlabel, moving the label roughly
  2481.  one character height up.
  2482.  
  2483.  The zlabel will be drawn whenever surfaces or contours are plotted,
  2484.  in the space above the grid level.
  2485.  
  2486.  (The LaTeX, EEPIC, and Imagen drivers allow \\ in a string to specify
  2487.  a newline.)
  2488. 3 zrange
  2489. ?set zrange
  2490. ?show zrange
  2491. ?zrange
  2492.  The `set zrange` command sets the vertical range that will be
  2493.  displayed. This command turns z axis autoscaling off.  The zrange is
  2494.  used only by `splot` and is ignored by `plot`.
  2495.  
  2496.  This range may also be specified on the `splot` command line.
  2497.  
  2498.  Syntax:
  2499.          set zrange [{<zmin> : <zmax>}]
  2500.  
  2501.  where <zmin> and <zmax> terms are constants or expressions.
  2502.  
  2503.  Both the <zmin> and <zmax> terms are optional. Anything omitted will
  2504.  not be changed, so
  2505.          set zrange [2:]
  2506.  changes zmin to 2 without affecting zmax.
  2507. 3 ztics
  2508. ?set ztics
  2509. ?set noztics
  2510. ?show ztics
  2511. ?ztics
  2512. ?noztics
  2513.  The `set ztics` and `set noztics` commands are similar to the `set
  2514.  xtics` and `set noxtics` commands. Please see `set xtics`.
  2515. 2 shell
  2516. ?shell
  2517.  The `shell` command spawns an interactive shell. To return to
  2518.  GNUPLOT, type `logout` if using VMS, `exit` or the END-OF-FILE
  2519.  character if using Unix, `endcli` if using AmigaDOS, or `exit` if
  2520.  using MS-DOS.
  2521.  
  2522.  A single shell command may be spawned by preceding it with the !
  2523.  character ($ if using VMS) at the beginning of a command line.
  2524.  Control will return immediately to GNUPLOT after this command is
  2525.  executed. For example, in VMS, AmigaDOS, or MS-DOS,
  2526.  
  2527.       ! dir
  2528.  
  2529.  prints a directory listing and then returns to GNUPLOT.
  2530. 2 splot
  2531.  Three-dimensional surface and contour plotting is available in
  2532.  GNUPLOT with the `splot` command. See the `plot` command for features
  2533.  common to the `plot` command.
  2534.  
  2535.  See also `set contour`, `set cntrparam`, and `set surface`.
  2536. 2 start-up
  2537. ?startup
  2538. ?start
  2539. ?.gnuplot
  2540.  When GNUPLOT is run, it looks for an initialization file to load.
  2541.  This file is called `.gnuplot` on Unix and AmigaDOS systems, and
  2542.  `GNUPLOT.INI` on other systems. If this file is not found in the
  2543.  current directory, the program will look for it in the home directory
  2544.  (under AmigaDOS and MS-DOS, the environment variable GNUPLOT should
  2545.  contain the name of this directory).
  2546.  
  2547.  If this file is found, GNUPLOT executes the commands in this file.
  2548.  This is most useful for setting the terminal type and defining any
  2549.  functions or variables that are used often.
  2550. 2 substitution
  2551. ?substitution
  2552.  Command-line substitution is specified by a system command enclosed in
  2553.  backquotes. This command is spawned and the output it produces
  2554.  replaces the name of the command (and backquotes) on the command line.
  2555.  
  2556.  Newlines in the output produced by the spawned command are replaced
  2557.  with blanks.
  2558.  
  2559.  Command-line substitution can be used anywhere on the GNUPLOT command
  2560.  line.
  2561.  
  2562.  Example:
  2563.  
  2564.  This will run the program `leastsq` and replace `leastsq` (including
  2565.  backquotes) on the command line with its output:
  2566.  
  2567.           f(x) = `leastsq`
  2568.  
  2569.  or, in VMS
  2570.  
  2571.           f(x) = `run leastsq`
  2572. 2 user-defined
  2573. ?userdefined
  2574. ?variables
  2575.  New user-defined variables and functions of one or two variables may be 
  2576.  declared and used anywhere.
  2577.  
  2578.  User-defined function syntax:
  2579.          <function-name> ( <dummy-var1> {,<dummy-var2>} ) =  <expression>
  2580.  
  2581.  where <expression> is defined in terms of <dummy-var1> and <dummy-var2>.
  2582.  
  2583.  User-defined variable syntax:
  2584.          <variable-name> = <constant-expression>
  2585.  
  2586.  Examples:
  2587.          w = 2
  2588.          q = floor(tan(pi/2 - 0.1))
  2589.          f(x) = sin(w*x)
  2590.          sinc(x) = sin(pi*x)/(pi*x)
  2591.          delta(t) = (t == 0)
  2592.          ramp(t) = (t > 0) ? t : 0
  2593.          min(a,b) = (a < b) ? a : b
  2594.          comb(n,k) = n!/(k!*(n-k)!)
  2595.  
  2596.  Note that the variable `pi` is already defined.
  2597.  
  2598.  See `show functions` and `show variables`.
  2599. 2 bugs
  2600. ?bugs
  2601.  The bessel functions do not work for complex arguments.
  2602.  
  2603.  The gamma function does not work for complex arguments.
  2604.  
  2605.  There is a bug in the stdio library for old Sun operating systems
  2606.  (SunOS Sys4-3.2). The "%g" format for 'printf' sometimes incorrectly
  2607.  prints numbers (e.g., 200000.0 as "2"). Thus, tic mark labels may be
  2608.  incorrect on a Sun4 version of GNUPLOT. A work-around is to rescale
  2609.  the data or use the `set format` command to change the tic mark format
  2610.  to "%7.0f" or some other appropriate format. This appears to have been
  2611.  fixed in SunOS 4.0.
  2612.  
  2613.  Another bug: On a Sun3 under SunOS 4.0, and on Sun4's under Sys4-3.2
  2614.  and SunOS 4.0, the 'sscanf' routine incorrectly parses "00 12" with
  2615.  the format "%f %f" and reads 0 and 0 instead of 0 and 12. This
  2616.  affects data input. If the data file contains x coordinates that are
  2617.  zero but are specified like '00', '000', etc, then you will read the
  2618.  wrong y values. Check any data files or upgrade the SunOS.
  2619.  It appears to have been fixed in SunOS 4.1.1.
  2620.  
  2621.  Microsoft C 5.1 has a nasty bug associated with the %g format for
  2622.  printf. When any of the formats "%.2g", "%.1g", "%.0g", "%.g" are
  2623.  used, printf will incorrectly print numbers in the range 1e-4 to 1e-1.
  2624.  Numbers that should be printed in the %e format are incorrectly 
  2625.  printed in the %f format, with the wrong number of zeros after the 
  2626.  decimal point.
  2627.  
  2628.  To work around this problem, use the %e or %f formats explicitly.
  2629.  
  2630.  GNUPLOT, when compiled with Microsoft C, did not work correctly on two
  2631.  VGA displays that were tested. The CGA, EGA and VGA drivers should 
  2632.  probably be rewritten to use the Microsoft C graphics library.
  2633.  GNUPLOT compiled with Turbo C uses the Turbo C graphics drivers and 
  2634.  does work correctly with VGA displays.
  2635.  
  2636.  VAX/VMS 4.7 C compiler release 2.4 also has a poorly implemented %g 
  2637.  format for printf. The numbers are printed numerically correct, but 
  2638.  may not be in the requested format. The K&R second edition says that 
  2639.  for the %g format, %e is used if the exponent is less than -4 or greater 
  2640.  than or equal to the precision. The VAX uses %e format if the exponent 
  2641.  is less than -1. The VAX appears to take no notice of the precision 
  2642.  when deciding whether to use %e or %f for numbers less than 1.
  2643.  To work around this problem, use the %e or %f formats explicitly.
  2644.  From the VAX C 2.4 release notes:
  2645.  e,E,f,F,g,G  Result will always contain a decimal  point.
  2646.  For g and G, trailing zeros will not be removed from the result.
  2647.  
  2648.  VAX/VMS 5.2 C compiler release 3.0 has a slightly better implemented
  2649.  %g format than release 2.4, but not much. Trailing decimal points are 
  2650.  now removed, but trailing zeros are still not removed from %g numbers 
  2651.  in exponential format.
  2652.  
  2653.  ULTRIX X11R3 has a bug that causes the X11 driver to display "every
  2654.  other" plot.  The bug seems to be fixed in DEC's release of X11R4 so
  2655.  newer releases of ULTRIX don't seem to have the problem.  Solutions for 
  2656.  older sites include upgrading the X11 libraries (from DEC or direct from 
  2657.  MIT) or defining ULTRIX_KLUDGE when compiling the x11.trm file.  Note 
  2658.  that the kludge is not an ideal fix, however.
  2659.  
  2660.  The constant HUGE was incorrectly defined in the NeXT OS 2.0 operating
  2661.  system.  HUGE should be set to 1e38 in plot.h. This error has been
  2662.  corrected in the 2.1 version of NeXT OS.
  2663.  
  2664.  Some older models of HP plotters do not have a page eject command 'PG'.
  2665.  The current HPGL driver uses this command in HPGL_reset.  This may need
  2666.  to be removed for these plotters.  The current PCL5 driver uses HPGL/2
  2667.  for text as well as graphics.  This should be modified to use scalable
  2668.  PCL fonts.
  2669.  
  2670.  Please report any bugs to bug-gnuplot@ames.arc.nasa.gov.
  2671.